REUSE  ECONOMICS  SPREADSHEET 
MODEL  USER  MANUAL 


SPC-91158-CMC 


VERSION  03.00.08 
JULY  1993 


***?%&* 


8  11  00i 


\  o 

\ 


93-18761 


REUSE  ECONOMICS  SPREADSHEET 
MODEL  USER  MANUAL 


SPC-91158-CMC 


VERSION  03.00.08 
JULY  1993 


Produced  by  the 

SOFTWARE  PRODUCTIVITY  CONSORTIUM  SERVICES  CORPORATION 

under  contract  to  the 

VIRGINIA  CENTER  OF  EXCELLENCE 
FOR  SOFTWARE  REUSE  AND  TECHNOLOGY  TRANSFER 

SPC  Building 
2214  Rock  Hill  Road 
Herndon,  Virginia  22070 

Copyright  ©  1991, 1992, 1993,  Software  Productivity  Consortium  Services  Corporation,  Herndon,  Virginia  Permission  to  use.  copy, 
modify,  and  distribute  this  material  for  any  purpose  and  without  fee  is  hereby  granted  consistent  with  48  CFR  227  and  25Z  and 
provided  that  the  above  copyright  notice  appears  in  all  copies  and  that  both  this  copyright  notice  and  this  permission  notice  appear 
in  supporting  documentation.  This  material  is  based  in  part  upon  work  sponsored  by  the  Advanced  Research  Projects  Agency 
under  Grant  #MDA972-92-J-1018.  The  content  does  not  necessarily  reflect  the  position  or  the  policy  of  the  U.  S.  Government, 
and  no  official  endorsement  should  be  inferred.  The  name  Software  Productivity  Consortium  shall  not  be  used  in  advertising  or 
publicity  pertaining  to  this  material  or  otherwise  without  the  prior  written  permission  of  Software  Productivity  Consortium.  Inc 
SOFTWARE  PRODUCTIVITY  CONSORTIUM,  INC.  AND  SOFTWARE  PRODUCTIVITY  CONSORTIUM 
SERVICES  CORPORATION  MAKE  NO  REPRESENTATIONS  OR  WARRANTIES  ABOUT  THE  SUITABIIJTY  OF 
THIS  MATERIAL  FOR  ANY  PURPOSE  OR  ABOUT  ,\NY  OTHER  MATTER.  AND  THIS  MATERIAL  IS  PROVIDED 
WITHOUT  EXPRESS  OR  IMPLIED  WARRANTY  OF  ANY  KIND. 


~CTED  3 


IBM  is  a  registered  trademark  of  International  Business  Machines  Corp. 
Macintosh  is  a  registered  trademark  of  Apple  Computer,  Inc, 

Windows  is  a  trademark  of  Microsoft  Corporation. 

Microsoft.  Excel,  and  DOS  are  registered  trademarks  of  Microsoft  Corporation. 


□  □ 


CONTENTS 


PREFACE .  xiii 

ACKNOWLEDGEMENTS .  xv 

1.  INTRODUCTION .  1-1 

1.1  Overview .  1-1 

1.2  Background .  1-1 

1.3  Audience  and  Purpose .  1-2 

1.4  User  Manual  Organization  .  1-2 

1.5  Typographic  Conventions .  1-2 

2.  USING  THE  TOOL  .  2-1 

2.1  Section  Overview .  2-1 

2.2  Reuse  Economics  Background .  2-1 

2.3  Selecting  the  Right  Model .  2-2 

2.4  Reuse  Cost  Questions  and  the  Tool .  2-3 

2.5  Guidelines  for  Estimating  Principal  Model  Parameters  .  2-6 

2.5.1  Selecting  a  Value  of  Cvn .  2-6 

2.5.2  Selecting  a  Value  of  Cvr  .  2-7 

2.5.3  Selecting  a  Value  of  Cde  .  2-8 

3.  INVOKING  THE  TOOL  .  3-1 

3.1  Instructions  for  the  Macintosh  Version  of  the  Reuse  Economics  Spreadsheet 

Model  Tool  .  3-1 

3.1.1  Recommended  Configuration  .  3-1 

3.1.2  Installing  the  Software  on  a  Hard  Disk .  3-1 


Contents 


3.1.3  Running  the  Reuse  Economics  Spreadsheet  Model  Tool .  3-2 

3. 1.3.1  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool 

From  a  Diskette .  3-2 

3. 1.3.2  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool 

From  a  Hard  Disk .  3-2 

3.2  Instructions  for  the  PC  Version  of  the  Reuse  Economics  Spreadsheet  Model  Tool .  3-2 

3.2.1  Recommended  Configuration .  3-2 

3.2.2  Installing  the  Software  on  a  Hard  Disk .  3-3 

3.2 A  Running  the  Reuse  Economics  Spreadsheet  Model  Tool .  3-3 

3.2.3. 1  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool 

From  a  Diskette .  3-3 

3.2.3.2  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool 

From  a  Hard  Disk .  3-4 

3.3  List  of  Files  Included  in  the  Macintosh  Version  of  the  Reuse  Economics 

Spreadsheet  Model  Tool .  3-4 

3.4  List  of  Files  Included  in  the  PC  Version  of  the  Reuse  Economics 

Spreadsheet  Model  Tool .  3-4 

4.  OPERATING  THE  TOOL .  4-1 

4.1  User  Interface  Conventions .  4-1 

4.1.1  Selecting  From  Menus  .  4-1 

4.1.2  Activating  a  Window .  4-1 

4.1.3  Menu  Bars  and  Active  Windows  .  4-1 

4.1.4  Closing  the  Active  Window .  4-1 

4.1.5  Sizing  the  Active  Window  .  4-2 

4.1.6  Scrolling  the  Active  Window .  4-3 

4.2  The  Start  Window .  4-3 

4.3  The  Main  Window .  4-3 

4.3.1  The  File  Menu  .  4-4 

4.3.2  The  Modes  Menu .  4-4 

4.3.3  The  Window  Menu  .  4-5 


IV 


Contents 


4.4  The  Mode  la  Window  .  4-6 

4.4.1  The  File  Menu  .  4-6 

4.4.2  Dialog  Box  Description  .  4-9 

4.4.3  The  Family  Menu .  4-10 

4.4.4  The  Graphs  Menu .  4-14 

4.4.4.1  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  Graph _  4-15 

4.4.4.2  Relative  Product  Productivity  vs  Relative  Reuse  Cost  Graph .  4-17 

4.4.4.3  Product  Productivity  vs  Number  of  Application  Systems  Graph .  4-21 

4.4.4.4  Return  on  Investment  vs  Number  of  Application  Systems  Graph .  4-24 

4.4.4.5  Labor  Months  vs  Number  of  Application  Systems  Graph .  4-26 

4.4.5  The  Window  Menu  .  4-28 

4.5  The  Mode  2  Window .  4-28 

4.5.1  The  File  Menu  .  4-34 

4.5.2  Dialog  Box  Description  .  4-35 

4.5.3  The  Family  Menu .  4-36 

4.5.4  The  Application  Menu .  4-41 

4.5.5  The  Graphs  Menu .  4-46 

4.5.5. 1  Labor  Months  vs  Number  of  Application  Systems  Graph .  4-46 

4.5.6  The  Window  Menu  .  4-48 

4.6  The  Mode  3  Window .  4-48 

4.6.1  The  File  Menu  .  4-55 

4.6.2  Dialog  Box  Description  .  4-55 

4.6.3  The  Family  Menu .  4-57 

4.6.4  The  Application  Menu .  4-62 

4.6.5  The  Graphs  Menu .  4-67 

4.6.5. 1  Labor  Months  vs  Number  of  Application  Systems  Graph  .  4-67 

4.6.6  The  Window  Menu  .  4-69 

4.7  The  Graph  Window  .  4-69 


Contents 


APPENDIX  A.  REUSE  ECONOMICS  MATHEMATICAL  MODELS  .  A-l 

A.1  Overview  .  A-l 

A.2  Mode  la— Reuse  With  Up-Front  Reuse  Program  Investment 

(Domain  Engineering) .  A-l 

A.2.1  Mode  la  Overview .  A-l 

A.2.2  Basic  Unit  Cost  Equation .  A-l 

A.2.3  Efficiency  of  Use  of  the  Library  Infrastructure .  A-3 

A.2.4  Return  and  Return  on  Investment .  A-4 

A.2.5  Break-Even  Number  of  Systems .  A-4 

A.3  Reuse  With  Incremental  Domain  Engineering  (Reuse  Program  Investment) .  A-5 

A.3.1  Cost  Models  for  Incremental  Reuse  Program  Investment .  A-5 

A.3.2  Selecting  Values  of  Cvn  and  Cvr  for  a  Specific  System  (Modes  2  and  3) . . .  A-6 

A.3.3  Break-Even  Number  of  Systems .  A-7 

A.3.4  Selection  of  Some  Parameter  Values  for  Modes  2  and  3  .  A-7 

A.4  Mode  2— Reuse  With  Incremental  Reuse  Program  Investment  Without 

Cost  of  Money  .  A-8 

A.4.1  Incremental  Reuse  Program  Investment  Example .  A-8 

A.4.2  Savings  and  Return  on  Investment .  A-ll 

A.5  Mode  3— Reuse  With  Incremental  Reuse  Program  Investment  With 

Cost  of  Money  .  A-ll 

A.5.1  Cost  of  Money .  A-ll 

A.5.2  Comments  on  Cost  of  Money  .  A- 14 

A.5.3  Savings  and  Return  on  Investment .  A-14 

GLOSSARY  .  Glo-1 

REFERENCES .  Ref-1 

INDEX .  Ind-1 


V| 


FIGURES 


Figure  4-1.  Reuse  Economics  Spreadsheet  Model  Menu  Hierarchy .  4-2 

Figure  4-2.  Start  Window  .  4-3 

Figure  4-3.  Main  Window .  4-4 

Figure  4-4.  Arrange  All  Window .  4-5 

Figure  4-5.  Mode  la  Window  (part  1) .  4-6 

Figure  4-6.  Mode  la  Window  (part  2) .  4-7 

Figure  4-7.  Mode  la  Window  (part  3) .  4-7 

Figure  4-8.  Mode  la— Add  Family  Dialog  Box .  4-11 

Figure  4-9.  Mode  la— Modify  Family  Dialog  Boxl .  4-12 

Figure  4-10.  Mode  la— Modify  Family  Dialog  Box2 .  4-12 

Figure  4-11.  Mode  la— Delete  Family  Dialog  Box .  4-13 

Figure  4-12.  Delete  Confirmation  Dialog  Box .  4-14 

Figure  4-13.  Mode  la— Graphl  Inputs  Dialog  Box .  4-15 

Figure  4-14.  Mode  la— Relative  Product  Productivity  vs  Proportion  of  Code 

Reuse  Graph  Window .  4-16 

Figure  4-15.  Mode  la— Graph2A  Inputs  Dialog  Box  .  4-18 

Figure  4-16.  Mode  la— Graph2B  Inputs  Dialog  Box  .  4-18 

Figure  4-17.  Mode  la— Relative  Product  Productivity  vs  Relative  Reuse  Cost 

Graph  Window .  4-19 

Figure  4-18.  Mode  la— Graph3  Inputs  Dialog  Box .  4-21 

Figure  4-19.  Mode  la— Product  Productivity  vs  Number  of  Application  Systems 

Graph  Window .  4-22 

Figure  4-20.  Mode  la— Graph4  Inputs  Dialog  Box .  4-24 


Figures 


Figure  4-21.  Mode  la— Return  on  Investment  vs  Number  of  Application  Systems 

Graph  Window .  4-25 

Figure  4-22.  Mode  la— Graph5  Inputs  Dialog  Box .  4-27 

Figure  4-23.  Mode  la— Labor  Months  vs  Number  of  Application  Systems 

Graph  Window .  4-27 

Figure  4-24.  Mode  2  Window  (part  1) .  4-29 

Figure  4-25.  Mode  2  Window  (part  2) .  4-29 

Figure  4-26.  Mode  2  Window  (part  3) .  4-30 

Figure  4-27.  Mode  2  Window  (part  4) .  4-30 

Figure  4-28.  Mode  2  Window  (part  5) .  4-31 

Figure  4-29.  Mode  2— Add  Family  Dialog  Box .  4-37 

Figure  4-30.  Mode  2— Modify  Family  Dialog  Boxl .  4-39 

Figure  4-31.  Mode  2— Modify  Family  Dialog  Box2 .  4-39 

Figure  4-32.  Mode  2— Delete  Family  Dialog  Box .  4-40 

Figure  4-33.  Mode  2— Add  Application  System  Dialog  Box .  4-42 

Figure  4-34.  Mode  2— Modify  Application  System  Dialog  Boxl .  4-43 

Figure  4-35.  Mode  2— Modify  Application  System  Dialog  Box2 .  4-43 

Figure  4-36.  Mode  2— Delete  Application  System  Dialog  Box  .  4-45 

Figure  4-37.  Mode  2— Graph  1  Inputs  Dialog  Box .  4-47 

Figure  4-38.  Mode  2— Labor  Months  vs  Number  of  Application  Systems 

Graph  Window .  4-48 

Figure  4-39.  Mode  3  Window  (part  1) .  4-49 

Figure  4-40.  Mode  3  Window  (part  2) .  4-49 

Figure  4-41.  Mode  3  Window  (part  3) .  4-50 

Figure  4-42.  Mode  3  Window  (part  4) .  4-50 

Figure  4-43.  Mode  3  Window  (part  5) .  4-51 

Figure  4-44.  Mode  3  Window  (part  6) .  4-51 

Figure  4-45.  Mode  3— Add  Family  Dialog  Box .  4-58 


viii 


Figures 


Figure  4-46.  Mode  3— Modify  Family  Dialog  Boxl .  4-59 

Figure  4-47.  Mode  3— Modify  Family  Dialog  Box2 .  4-60 

Figure  4-48.  Mode  3— Delete  Family  Dialog  Box .  4-61 

Figure  4-49.  Mode  3— Add  Application  System  Dialog  Box .  4-63 

Figure  4-50.  Mode  3— Modify  Application  System  Dialog  Boxl .  4-64 

Figure  4-51.  Mode  3— Modify  Application  System  Dialog  Box2 .  4-64 

Figure  4-52.  Mode  3— Delete  Application  System  Dialog  Box .  4-66 

Figure  4-53.  Mode  3— Graphl  Inputs  Dialog  Box .  4-68 

Figure  4-54.  Mode  3— Graphl  Window .  4-68 

Figure  4-55.  Graph  Save  Dialog  Box .  4-70 


1\ 


TABLES 


Table  2-1.  Mode/Model  Capability  Summary .  2-2 

Table  2-2  Software  Development  Process  Unit  Costs  by  Activity  .  2-7 

Table  2-3.  Ada  Development  Model  Unit  Costs .  2-7 

Table  4-1.  Mapping  of  Worksheet  Column  Names  to  Reuse  Economic  Model 

Variable  Names  .  4-8 

Table  4-2.  Input  Data  Values  for  Relative  Product  Productivity  vs 

Proportion  of  Code  Reuse  Graph  Window .  4-16 

Table  4-3.  Input  Data  Values  for  Relative  Product  Productivity  vs 

Relative  Reuse  Cost  Graph  Window  .  4-20 

Table  4-4.  Input  Data  Values  for  Product  Productivity  vs 

Number  of  Application  Systems  Graph  Window  .  4-23 

Table  4-5.  Input  Data  Values  for  Return  on  Investment 

vs  Number  of  Application  Systems  Graph  Window .  4-25 

Table  4-6.  Input  Data  Values  for  Laoor  Months  vs  Number  of  Application 

Systems  Graph  Window .  4-28 

Table  4-7.  Mapping  of  Worksheet  Column  Names  to  Reuse  Economic  Model 

Variable  Names  .  4-31 

Table  4-8.  Input  Data  Values  for  Labor  Months  vs  Number  of  Application 

Systems  Graph  Window .  4-47 

Table  4-9.  Mapping  of  Worksheet  Column  Names  to  Reuse  Economic  Model 

Variable  Names  .  4-52 

Table  4-10.  Input  Data  Values  for  Labor  Months  vs  Number  of  Application 

Systems  Graph  Window .  4-69 

Table  A-l.  Costs  for  Four  Alternative  Reuse  Program  Investment  Strategies 

(Without  Cost  of  Money)  .  A-8 

Table  A-2.  Library  Code  Development  Allocations  .  A-9 


Tables 


Table  A-3,  Reuse  Program  Investment  Apportionment  per  System  for  Case  4 .  A- 10 

Table  A-4.  Reuse  Program  Investment  Apportionment  per  System  With 

Cost  of  Money  for  Case  1 .  A- 12 

Table  A-5.  Reuse  Program  Investment  Apportionment  per  System  With 

Cost  of  Money  for  Case  4 .  A- 12 

Table  A-6.  Costs  for  Two  Alternative  Reuse  Program  Investment  Strategies 

With  Cost  of  Money  .  A-12 


XI 


This  page  intentionally  left  blank. 


PREFACE 


The  Reuse  Economics  Spreadsheet  Model  tool  implements  various  portions  of  the  software  reuse 
economics  model  described  in  Cruickshank  and  Gaffney  (1991).  The  model  described  in  the  report 
was  conceived  to  demonstrate  the  economic  benefits  of  software  reuse.  You  should  be  thoroughly 
familiar  with  this  report  to  most  effectively  use  the  tool. 

The  Reuse  Economics  Spreadsheet  Model  tool  was  designed  to  help  you  evaluate  the  potential  impact 
of  various  reuse  strategies  on  the  costs  of  software  products.  The  tool  provides  both  spreadsheet  and 
graphics  capabilities.  It  requires  the  use  of  Microsoft  Excel,  version  4.0,  and  can  operate  on  either 
a  Macintosh  or  an  IBM-compatible  PC. 

The  tool  can  operate  in  any  one  of  five  modes: 

•  Mode  la:  Basic  Model— Reuse  With  Up-Front  Reuse  Program  Investment 

•  Mode  lb:  Intraproject  Reuse 

•  Mode  2:  Incremental  Reuse  Program  Investment  Without  Cost  of  Money 

•  Mode  3:  Incremental  Reuse  Program  Investment  With  Cost  of  Money 

•  Mode  4:  Basic  Model  Plus  Reuse  of  Requirements  and/or  Design 
Note :  Mode  4  provides  a  breakout  of  requirements  and  design. 

The  version  of  the  tool  documented  in  this  user  manual  operates  only  in  Modes  la,  2,  and  3. 

The  estimates  of  reuse  costs,  productivity,  return  on  investment,  and  number  of  break-even  systems 
implemented  in  the  Reuse  Economics  Spreadsheet  Model  tool  are  just  that— estimates.  Mathematics 
cannot  make  estimates  into  certainties.  It  is  very  important  for  you.  as  the  user  of  this  tool,  to  note 
that  the  results  of  its  application  can  be  no  better  than  the  data  it  employs.  If  you  do  not  have  an  accu¬ 
rate  idea  of  how  much  it  costs  to  create  new  code,  to  reuse  code,  and  to  invest  in  a  reuse  program, 
the  numbers  that  the  tool  generates  will  be  correspondingly  inaccurate. 
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1.  INTRODUCTION 


1.1  OVERVIEW 

This  document  is  the  user  manual  for  version  3  of  the  Reuse  Economics  Spreadsheet  Model  tool,  which 
provides  automated  support  for  performing  economic  analyses  of  various  software  reuse  strategies. 
The  tool  is  implemented  on  version  4.0  of  the  Microsoft  Excel  spreadsheet.  You  can  operate  it  using 
either  a  Macintosh  or  an  IBM-compatible  PC.  It  provides  both  spreadsheet  and  graphics  capabilities. 

Note :  Due  to  the  incompatibility  between  versions  of  the  tool,  any  existing  data  from  previous 
versions  will  need  to  be  reentered  for  use  in  version  3. 

Section  2  summarizes  the  model,  which  is  presented  in  detail  in  Cruickshank  and  Gaffney  (1991).  You 
should  become  familiar  with  this  report  before  using  the  Reuse  Economics  Spreadsheet  Model  tool 
to  use  it  with  maximum  effectiveness. 

1.2  BACKGROUND 

A  software  system  consists  of  two  categories  of  code:  new  and  reused  (Gaffney  and  Cruickshank  1992; 
IEEE  1993).  New  source  statements  are  those  newly  created  or  modified  for  the  software  system. 
Reused  source  statements  are  those  unmodified  source  statements  obtained  for  the  product  from  an 
external  source,  which  could  be  a  reuse  library  (IEEE  1993).  The  object  of  reuse  is  to  avoid  building 
a  new  software  product  entirely  from  scratch.  The  major  benefits  that  can  be  realized  from  reuse  include: 

•  Reducing  development  and  overall  life  cycle  costs,  thus  saving  money  and  enhancing 
productivity 

•  Enhancing  software  product  quality 

•  Reducing  the  amount  of  time  required  for  development 

•  Enabling  more  software  to  be  developed,  thus  reducing  software  applications  backlog 

Investment  is  required  for  an  organization  to  realize  the  benefits  of  a  reuse  program.  Such  investment 
may  be  in  such  items  as:  program  planning  and  the  initial  stages  of  implementation,  the  characteriza¬ 
tion  of  application  systems  that  will  benefit  from  reuse,  the  location  and  collection  of  reusable  soft¬ 
ware,  the  definition  of  domains,  the  establishment  of  reuse  libraries  or  repositories,  and  the 
development  of  systems  to  aid  in  the  instantiation  of  reused  software  into  application  systems.  All 
are  important  components  of  the  investment  in  a  reuse  program.  A  given  reuse  program  may  not 
include  all  of  these  components,  but  it  will  include  some  of  them.  Thus,  an  investment  will  be  required. 
It  is  necessary  to  plan  both  the  amount  of  investment  and  the  pattern  of  investment.  The  spreadsheet 
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tool  presented  here  offers  help  in  performing  “what  if”  analyses  to  aid  in  this  planning.  The  Reuse 
Economics  Spreadsheet  Model  tool  supports  investigations  of  the  economic  viability  of  software  reuse 
in  specific  situations. 

1 3  AUDIENCE  AND  PURPOSE 

The  intended  audience  for  the  Reuse  Economics  Spreadsheet  Model  tool  includes  senior-level  line 
engineers,  project  managers,  and  operational  area  managers  interested  in  exploring  economic  trade¬ 
offs  involved  in  software  reuse.  You  can  use  the  Reuse  Economics  Spreadsheet  Model  tool  to  help 
you  analyze  the  potential  impact  of  adopting  various  reuse  strategies  on  the  overall  cost  of  software 
development.  The  tool  enables  you  to  examine  the  effects  on  the  software  product  development  cost 
of  varying  certain  parameters,  such  as  the  proportion  of  code  reused,  the  unit  cost  of  development 
for  new  code,  and  the  unit  cost  of  reusing  code. 

1.4  USER  MANUAL  ORGANIZATION 

This  manual  describes  how  to  use  the  Reuse  Economics  Spreadsheet  Model  tool.  It  illustrates  some 
of  the  ways  you  can  analyze  the  potential  impact  of  adopting  various  reuse  strategies  on  the  overall 
cost  of  software  development.  The  main  body  of  the  manual  is  organized  as  follows: 

•  Section  2,  Modes  of  Operation,  summarizes  the  reuse  economics  models  implemented  in  the 
tool. 

•  Section  3,  Invoking  the  Tool,  describes  how  to  install  and  open  the  Reuse  Economics 
Spreadsheet  Model  tool. 

•  Section  4,  Operating  the  Tool,  describes  the  menu  bar  selections  and  windows  presented  when 
using  the  tool. 

Appendix  A,  Reuse  Economics  Mathematical  Models,  presents  guidelines  to  follow  to  derive  esti¬ 
mates  of  the  parameters  that  drive  the  model. 

The  Glossary  section  provides  definitions  for  terms  used  in  this  manual. 

The  References  section  identifies  sources  of  information  used  in  this  manual. 

1.5  TYPOGRAPHIC  CONVENTIONS 

This  manual  uses  the  following  typographic  conventions: 


Serif  font . General  presentation  of  information. 

Italicized  serif  font .  Publication  titles. 

Boldfaced  serif  font .  Section  headings  and  emphasis. 

[  ] . Screen  buttons. 

<  >  . Workstation  keyboard  key  names,  such  as  <  RETURN  > 

for  the  Return  key. 
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2.1  SECTION  OVERVIEW 

This  section  describes  how  you  can  use  the  Reuse  Economics  Spreadsheet  Model  tool  to  aid  you  in 
analyzing  the  costs  and  related  economic  parameters  of  interest  in  connection  with  the  development 
of  new  application  software  systems  that  are  composed,  in  part,  of  reused  code.  You  should  find  the 
tool  to  be  useful  in  various  situations,  such  as  product  planning  and  forecasting,  developing  cost  pro¬ 
posals,  and  analyzing  the  potential  payoff  of  investment  in  reuse  support  and  other  software  develop¬ 
ment  technology.  The  tool  has  three  modes  of  operation,  each  of  which  provides  an  analysis  support 
capability.  This  section  summarizes  those  capabilities.  The  tool  can  help  you  to  answer  various  ques¬ 
tions  concerning  the  cost  and  related  parameters  of  new  systems  constructed,  in  part,  of  reused  code. 
This  section  cites  some  of  these  questions.  It  also  provides  you  guidance  for  selecting  the  values  of 
the  three  principal  cost  parameters  used  in  the  operation  of  the  tool.  Other  sections  of  this  manual 
provide  additional  details  about  using  the  tool  and  the  nature  of  the  mathematical  models  that  it  im¬ 
plements.  Section  4  shows  you  how  to  operate  the  tool,  stepping  you  through  the  operation  of  each 
of  its  modes  of  operation.  Appendix  A  presents  the  mathematical  models  that  underlie  the  operation 
of  the  tool. 

2.2  REUSE  ECONOMICS  BACKGROUND 

This  section  provides  some  background  about  the  costs  of  developing  new  application  software 
systems  that  consist  of  new  and  reused  code  that  should  aid  you  in  exploiting  the  capabilities  of  the 
Reuse  Economics  Spreadsheet  Model  tool. 

The  cost  of  developing  a  new  application  system  is  equal  to  the  sum  of  the  prorated  cost  of  domain 
engineering  plus  the  cost  for  creating  the  particular  application  system,  the  application  engineering 
activity.  Domain  engineering  is  the  capital  investment  involved  in  the  process  of  making  reusable  soft¬ 
ware  objects  (RSOs)  to  be  employed  in  a  family  of  application  systems.  A  family  is  a  set  of  application 
systems  that  are  similar  (Parnas  1976).  Each  of  the  application  systems  in  a  family  includes  reused 
software  components  from  a  repository  or  library.  The  similarity  among  application  systems  in  a  fami¬ 
ly  is  evidenced  by  the  amounts  of  their  reuse  of  library  components.  The  model  tool  defines  the  capac¬ 
ity  of  the  library  as  the  proportion  of  the  application  system  code  that  is  provided  by  the  library  or 
repository  of  RSOs.  The  model  also  defines  a  related  parameter,  the  library  efficiency;  this  is  the 
proportion  of  RSOs  in  the  library  actually  used  in  an  application  system. 

One  tool  user’s  view  of  the  economics  of  reuse  may  differ  from  that  of  another.  In  some  cases,  the 
cost  of  reuse  program  investment  may  not  be  a  consideration  to  a  user.  For  example,  if  a  contractor 
for  the  government  receives  the  RSOs  free  from  the  government  for  incorporation  into  an  application 
system  (or  an  entire  family  of  application  systems),  he  probably  would  not  use  the  reuse  program 
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investment  or  domain  engineering  term  in  the  cost  model  when  evaluating  his  cost  picture.  However, 
the  government  program  manager,  program  executive  officer,  or  other  such  official  would  probably 
be  very  interested  in  issues  such  as  the  likely  payoff  on  his  investment  and,  thus,  would  use  the  domain 
engineering  term  in  the  model.  Similarly,  a  government  contractor  or  other  developer  of  software 
would  use  the  investment  (domain  engineering  term)  to  facilitate  his  consideration  of  the  economics 
of  investing  in  the  creation  of  a  family  of  systems. 

The  models  implemented  in  the  tool  assume  that  there  is  code  reuse  as  well  as  reuse  of  the  corresponding 
design  and  requirements.  Other  reuse  regimes  are  possible,  such  as  where  there  is  some  or  even  no 
code  reuse  but  there  is  reuse  of  design  and  requirements.  Section  G.2  of  the  Reuse  Adoption  Guidebook 
(Software  Productivity  Consortium  1992a)  and  the  paper  by  Gaffney  and  Cruickshank  (1992)  describe 
such  more  general  cases  of  reuse.  The  models  implemented  in  this  version  of  the  tool  do  not  represent 
such  situations;  however,  they  may  be  covered  by  another  mode  of  operation  implemented  in  a  future 
version  of  the  tool. 

23  SELECTING  THE  RIGHT  MODEL 

The  Reuse  Economics  Spreadsheet  Model  tool  provides  three  different  modes  of  operation  to  help 
you  determine  the  answers  to  various  cost  related  questions,  such  as  those  indicated  above.  The  three 
modes  are: 

•  Mode  la— Basic  Model 

•  Mode  2— Incremental  Reuse  Program  Investment  Without  Cost  of  Money 

•  Mode  3— Incremental  Reuse  Program  Investment  With  Cost  of  Money 
The  applicability  of  each  mode  is  summarized  in  Table  2-1. 


Table  2-1.  Mode/Model  Capability  Summary 


Mode/Model 


Capability 


You  should  use  this  mode  to  represent  cases  in  which 
all  of  the  reuse  program  investment  (domain  engi¬ 
neering)  is  done  at  one  time  up  front,  simultaneously 
with,  or  before  the  development  of  the  first  applica¬ 
tion  system  of  the  family  of  systems. 

Also,  you  can  use  this  mode  without  the  investment 
term  to  represent  the  case  of  no  investment: 

•  When  you  reuse  software  whose  cost  was 
expensed  by  the  project  that  developed  it 

•  If  your  organization  is  not  doing  the 
investment  (e.g.,  if  you  receive  the  software 
free  from  the  government) 

•  When  the  cost  of  doing  it  is  provided  under 
a  separate  contract 
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Thble  2-1,  continued 


Mode  2— Incremental  Reuse  Program  Investment 
Without  Cost  of  Money 

This  mode  provides  a  generalization  of  the  model 
used  in  Mode  la. 

You  should  use  this  mode  to  represent  the  case  in 
which  all  of  the  reuse  program  investment  (domain 
engineering)  is  not  done  up  front  but  is  done 
incrementally. 

You  should  use  this  mode  if  you  want  to  use  a  more 
general  model  than  that  provided  in  Mode  la  that 
allows  different  costs  to  be  used  for  developing  new 
software  or  reusing  software  or  different  amounts  of 
reuse  in  each  of  the  application  systems  in  the  family 
of  systems  under  consideration. 

This  mode  also  enables  you  to  represent  the  situation 
in  which  the  costs  of  developing  or  reusing  code 
change  over  the  period  of  development  of  a  family  of 
systems.  Thus,  you  can  use  it  to  reflect  the  impact  of 
software  development  technology  improvement  in 
your  development  organization  over  this  period. 

Mode  3— Incremental  Reuse  Program  Investment 
With  Cost  of  Money 

You  should  use  this  mode  in  any  of  the  circumstances 
in  which  you  would  apply  the  Mode  2  model  and  in 
which  you  wish  to  represent  the  effect  of  the  cost  of 
money. 

You  should  note  that  the  model  implemented  in  Mode  la  of  the  Reuse  Economics  Spreadsheet  Model 
tool  assumes  that  the  cost  of  domain  engineering  (or  reuse  program  investment)  is  incurred  “up  front” 
at  or  before  the  creation  of  the  first  of  the  set  (or  family)  of  application  systems.  Modes  2  and  3  provide 
more  general  models  in  which  the  reuse  program  investment  costs  may  be  incurred  at  several  times 
during  the  period  that  the  set  or  family  of  application  systems  is  developed.  Mode  2  supports  the  ex¬ 
amination  of  the  case  of  incremental  reuse  program  investment  without  considering  the  cost  of  money, 
and  Mode  3  supports  the  examination  of  the  case  of  incremental  reuse  program  investment  considering 
the  cost  of  money. 

2.4  REUSE  COST  QUESTIONS  AND  THE  TOOL 

You  can  use  the  Reuse  Economics  Spreadsheet  Model  tool  to  help  you  answer  various  questions  about 
an  analysis  of  the  economics  of  reuse  in  your  development  environment.  Section  2.4  presents  some 
of  the  questions  that  you  might  pose  during  an  analysis  of  the  economics  of  reuse  and  relates  them 
to  the  portions  of  Section  4  that  are  relevant.  Section  4  illustrates  the  operation  of  the  tool,  including 
the  generation  of  various  graphs,  with  simulated  project  data.  The  tool  provides  you  with  graphical 
outputs  as  stated.  It  also  provides  you  with  more  data  on  the  spreadsheet,  as  illustrated  in  Section  4. 
for  each  example  covered.  Note  that  Section  2.5  provides  detailed  guidance  on  the  selection  of  the  three 
principal  cost  parameters  cited  with  reference  to  the  cost  questions  below:  the  Unit  Cost  of  Reuse 
Program  Investment,  the  Unit  Cost  of  New  Code,  and  the  Unit  Cost  of  Reused  Code. 

•  What  is  the  increase  in  the  productivity  of  developing  a  new  system  for  a  given  amount  of  code 
reuse? 
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You  can  use  the  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  Graph  provided 
by  Mode  la  (see  Section  4.4.6)  to  help  you  answer  this  question.  This  graph  provides  you  with 
plots  of  Relative  Product  Productivity  (productivity  of  creating  the  application  system  with 
reused  code  relative  to  productivity  if  only  new  code  were  used  in  the  development  effort)  ver¬ 
sus  Proportion  of  Code  Reuse.  You  can  obtain  up  to  three  different  plots  on  the  graph  that 
differ  with  respect  to  the  Number  of  Application  Systems.  You  enter  Number  of  Application 
Systems,  Proportion  of  Code  Reuse,  Library  Efficiency,  the  Unit  Cost  of  Reuse  Program  In¬ 
vestment,  the  Unit  Cost  of  New  Code,  and  the  Unit  Cost  of  Reused  Code.  The  tool  calculates 
Relative  Product  Productivity  and  Relative  Library  Capacity.  The  tool  also  calculates  the 
Product  Productivity  based  on  your  inputs  using  an  equation  described  in  Appendix  A  and 
then  obtains  the  Relative  Product  Productivity  from  it  by  relating  it  to  the  Unit  Cost  of  New 
Code. 

•  How  is  the  productivity  of  developing  a  new  system  affected  by  the  cost  of  reusing  code? 

You  can  use  the  Relative  Product  Productivity  vs  Relative  Reuse  Cost  Graph  provided  by 
Mode  la  (see  Section  4.4.6)  to  help  you  answer  this  question.  This  graph  provides  you  with 
plots  of  Relative  Product  Productivity  (productivity  of  creating  the  application  system  with 
reused  code  relative  to  productivity  if  only  new  code  were  used  in  the  development  effort)  ver¬ 
sus  Relative  Reuse  Cost.  You  enter  the  same  data  as  described  in  connection  with  answering 
the  preceding  question.  The  tool  calculates  the  Relative  Reuse  Cost  (the  unit  cost  of  reusing 
code  relative  to  the  unit  cost  of  developing  new  code)  based  on  the  data  that  you  have  entered. 
The  tool  also  calculates  the  Product  Productivity  based  on  your  inputs  using  an  equation  de¬ 
scribed  in  Appendix  A  and  then  obtains  the  Relative  Product  Productivity  from  it  by  relating 
it  to  the  Unit  Cost  of  New  Code.  You  can  obtain  up  to  three  different  plots  on  the  graph  that 
differ  with  respect  to  the  Proportion  of  Code  Reuse. 

•  How  is  the  productivity  of  developing  a  new  system  affected  by  the  number  of  systems  that 
share  (“reuse”)  code? 

You  can  use  the  Product  Productivity  vs  Number  of  Applications  Graph  provided  by  Mode 
la  (see  Section  4.4.6)  to  help  you  answer  this  question.  This  graph  provides  you  with  plots  of 
Product  Productivity  (productivity  of  creating  the  application  system,  including  the  effect  of 
employing  reused  code  in  it )  versus  Number  of  Application  Systems.  You  enter  the  same  data 
as  described  in  connection  with  answering  the  preceding  question.  The  tool  calculates  the 
Product  Productivity  based  on  your  inputs  using  an  equation  described  in  Appendix  A.  You 
can  obtain  up  to  three  different  plots  on  the  graph  that  differ  with  respect  to  the  Proportion 
of  Code  Reuse. 

•  How  many  application  systems  must  I  plan  to  develop  for  a  certain  investment  in  reuse  to  pay 
off  (break  even),  based  on  prorating  the  cost  of  that  investment  over  those  systems? 

You  can  use  the  Return  on  Investment  vs  Number  of  Applications  Graph  provided  by  Mode 
la  (see  Section  4.4.6)  to  help  you  answer  this  question.  This  graph  provides  you  with  plots  of 
Return  on  Investment  versus  Number  of  Application  Systems.  You  can  obtain  up  to  three 
different  plots  on  the  graph  that  differ  with  respect  to  the  Library  Efficiency.  You  enter  Num¬ 
ber  of  Application  Systems.  Library  Efficiency,  the  Unit  Cost  of  Reuse  Program  Investment, 
the  Unit  Cost  of  New  Code,  and  the  Unit  Cost  of  Reused  Code.  The  tool  calculates  the  Return 
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on  Investment  based  on  the  data  that  you  enter.  It  also  calculates  the  Number  of  Break-Even 
Systems  for  each  of  up  to  three  graphs  you  have  plotted.  This  is  the  number  of  application 
systems  in  a  family  of  systems  at  which  the  total  cost  of  developing  the  application  systems 
with  all  new  code  is  equal  to  the  total  cost  of  developing  them  with  the  proportion  of  reused 
code  that  you  have  stipulated.  The  number  of  application  systems  in  the  family  must  exceed 
the  break-even  figure  for  the  investment  in  reuse  to  pay  off. 

•  What  is  the  cost  of  developing  each  of  a  set  (“family”)  of  similar  systems  given  that  I  plan  a 
certain  domain  engineering  (capital  investment)  strategy  for  the  development  of  RSOs  whose 
development  cost  is  to  be  amortized  over  a  set  (“family”)  of  similar  systems  that  will  use  them? 

You  can  use  the  Labor  Months  vs  Number  of  Application  Systems  Graph  provided  by  Mode 

2  (see  Section  4.5.7)  to  help  you  answer  this  question.  This  graph  provides  you  with  four  bar 
graphs  for  each  application  system  in  the  family  of  systems  whose  costs  you  are  considering. 
They  are  Reuse  Program  Investment  (associated  with  the  development  of  this  application  sys¬ 
tem),  Cost  per  System  With  All  New  Code,  Application  Engineering  Cost  (development  cost) 
per  System,  and  Reuse  Program  Investment  Cost  per  System.  The  last  item  is  the  pro  rata  allo¬ 
cation  of  the  reuse  program  cost  allocated  to  the  development  of  this  particular  application 
system.  The  tool  calculates  all  of  the  bar  graph  values.  You  consider  a  family  of  systems.  For 
each  family,  you  enter  the  Family  Number  and  Number  of  Application  Systems  in  that  family, 
and  the  total  Size  of  the  Reuse  Library.  Then,  for  each  family  member,  call  it  the  ilh,  you  enter 
the  Application  Number,  the  Unit  Cost  of  New  Code  for  the  ith  Application  System,  the  Unit 
Cost  of  Reused  Code  for  the  ilh  Application  System,  the  Amount  of  Reuse  Library  associated 
with  the  ith  Application  System  (how  much  of  the  total  library  of  RSOs  will  be  developed  in 
association  with  the  creation  of  the  ith  application  system),  the  Amount  of  New  Code  Devel¬ 
oped  for  the  ith  Application  System,  and  the  Amount  of  Reused  Code  Incorporated  in  the  ith 
Application  System.  The  tool  calculates  the  Total  Size  of  the  ith  Application  System,  the  Rela¬ 
tive  Library  Capacity  for  the  ith  Application  System,  and  the  Unit  Cost  for  the  ith  Application 
System.  Mode  2  and  these  plots  do  not  consider  the  effect  of  the  cost  of  money.  The  cost  of 
money  is  covered  by  Mode  3  operation  (see  next  question). 

•  What  is  the  cost  of  developing  each  of  a  set  (“family”)  of  similar  systems  given  that  I  plan  a 
certain  domain  engineering  (capital  investment)  strategy  for  the  development  of  RSOs  whose 
development  cost  is  to  be  amortized  over  a  set  ("family")  of  similar  systems  that  will  use  them 
for  some  cost  of  money? 

You  can  use  the  Labor  Months  vs  Number  of  Application  Systems  Graph  provided  by  Mode 

3  (see  Section  4.6)  to  help  you  answer  this  question.  This  graph  provides  you  with  four  bar 
graphs  for  each  application  system  in  the  family  of  systems  whose  costs  you  are  considering. 
They  are  Reuse  Program  Investment  (associated  with  the  development  of  this  application  sys¬ 
tem),  Cost  of  Money  per  System,  Application  Engineering  Cost  (development  cost)  per  Sys¬ 
tem,  and  Reuse  Program  Investment  Cost  per  System.  The  too!  calculates  these  values  for  you. 
In  addition  to  the  data  that  you  have  to  enter  to  answer  the  preceding  question,  when  answer¬ 
ing  this  one  (and  operating  the  tool  in  Mode  3).  you  must  also  enter  the  Interest  Rate  (the  cost 
of  money)  and  the  Number  of  Years  (between  the  developments  of  the  application  systems 
in  the  family). 
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2.5  GUIDELINES  FOR  ESTIMATING  PRINCIPAL  MODEL  PARAMETERS 

A  key  aspect  of  using  the  cost  models  implemented  in  the  Reuse  Economics  Spreadsheet  Model  tool 
is  selecting  appropriate  values  of  the  parameters  used  in  it.  This  section  provides  you  guidance  for 
selecting  values  for  the  three  principal  cost  parameters  used  in  the  tool. 

The  Reuse  Economics  Spreads!  et  Model  tool  defines  the  cost  (LM  or  labor  months)  of  creating  a 
new  software  application  system  as  the  sum  of: 

•  The  cost  of  domain  engineering  prorated  over  the  number  of  application  systems  that  use  the 
code  that  the  domain  engineering  activity  produces 

•  The  cost  of  developing  the  new  code  made  especially  for  this  application  system 

•  The  cost  of  reusing  existing  code  in  the  application  system  obtained  from  the  repository  or 
other  source 

Each  of  these  costs  is  given  as  the  product  of  a  unit  cost  (LM  per  thousand  source  lines  of  code 
[KSLOC])  and  the  amount  of  code  (KSLOC)  to  which  it  applies.  The  remainder  of  Section  2.5  tells 
you  how  to  select  values  of  the  unit  costs  of  domain  engineering  (Cde>  developing  new  code  (Cvn). 
and  reusing  code  (Cvr).  You  must  have  or  be  able  to  estimate  values  of  the  parameters  Cvn-  Cvr,  and 
Cde  to  be  able  to  successfully  apply  the  tool  to  any  reuse  economics  application. 

The  values  of  all  of  the  parameters  used  in  the  tool  are  listed  in  Section  4.  The  dialog  boxes  in  Section  4 
associated  with  each  mode  define  which  parameters  are  entered  and  which  are  computed  by  the  tool. 
Appendix  A  provides  more  detailed  information  about  these  parameters,  defining  them  in  terms  of 
the  mathematical  models  in  which  they  are  incorporated  and  which  are  implemented  in  the  tool. 

2.5.1  Selecting  a  Value  of  Cvn 

You  should  select  a  value  for  Cvn.  the  unit  cost  of  developing  new  code,  based  on  your  knowledge  of 
the  development  process  to  be  used  in  creating  the  application  system  or  systems  of  interest.  Alterna¬ 
tively.  you  can  estimate  the  value  of  this  parameter  based  on  data  from  previous  development  projects. 
If  actual  values  from  several  previous  projects  are  available  and  if  the  set  of  development  activities 
is  the  same  or  comparable  to  the  new  development  effort  contemplated,  then  the  unit  costs  for  all  the 
projects  (assuming  the  same  type  of  software  application)  can  be  averaged.  The  Software  Measurement 
Guidebook  (Software  Productivity  Consortium  1992b)  provides  a  comprehensive  description  of  estimating 
software  development  costs  that  you  should  find  useful  in  estimating  Cvn- 

Cruickshank  and  Lesser  (1982)  and  Cruickshank  ( 1987)  show  the  software  development  unit  costs  for 
several  development  processes.  These  unit  costs  are  values  representative  of  actual  development  pro¬ 
cess  performance  based  on  accounting  records  that  used  a  separate  cost  account  for  each  activity  with¬ 
in  the  development  process.  The  later  paper  included  the  unit  costs  which  are  shown  in  Table  2-2. 
These  unit  costs  are  based  on  actual  experience  in  the  development  of  real-time  command  and  control 
application  software  using  the  CMS-2  language. 

The  Software  Measurement  Guidebook  (Software  Productivity  Consortium  1992b)  shows  the  unit  costs 
of  an  Ada-based  development  process.  The  10.00  LM/KSLOC  overall  unit  cost  corresponds  to  some 
industry  experience.  This  data  is  shown  in  Table  2-3. 
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The  default  value  of  Cvn  *n  the  Reuse  Economics  Spreadsheet  Model  is  5.00  LM/KSLOC.  This  is  the 
value  used  in  the  examples  in  Section  4.  You  can  override  this  value  with  your  own  value  or  you  can 
use  the  data  in  Tables  2-2  or  2-3  as  a  basis  for  estimating  a  value  of  Cvn  that  is  representative  of  your 
own  development  process. 


Table  2-2.  Software  Development  Process  Unit  Costs  by  Activity 


Development  Activity 

Unit  Cost 
(LM/KSLOC) 

Requirements  Analysis 

0.300 

Development  Plan 

0.150 

Preliminary  Design 

0.600 

Detailed  Design 

0.860 

Test  Plans 

0.250 

Software  Tools  (Utilities)  Development 

0.250 

Design  Evaluation  (Reviews) 

0.260 

Code  and  CSU  Test 

2.400 

Problem  Analysis  and  Error  Correction 

0.640 

Software  Integration 

1.500 

Test  Procedures 

1.000 

Acceptance  Test 

0.250 

Total 

8.460 

Table  2-3.  Ada  Development  Model  Unit  Costs 


Activity 

Unit  Cost 
LM/KSLOC 

Requirements  Analysis 

0.74 

Preliminary  Design 

1.67 

Detailed  Design 

2.22 

Code  and  Unit  Test 

2.22 

CSC  Integration  Test 

1.60 

CSCI  Test 

1.55 

Total 

10.00 

2.5.2  Selecting  a  Valle  of  Cvr 

You  can  estimate  the  unit  cost  of  reusing  code  in  an  application  system.  Cvr.  by  considering  it  in  terms 
of  its  proportion  of  the  cost  of  developing  new  code.  Cvn-  Values  in  the  range  of  0.20  to  0.30  for 
Cvr/Cvn  are  reasonable  in  the  light  of  experience.  A  value  of  0.31  is  given  in  Margono  and  Rhoads 
(1992)  for  the  cost  of  reusing  software  relative  to  the  cost  of  developing  new  software.  This  value  applies 
to  the  case  of  "domain  specific  reuse  packaging."  This  same  type  of  reuse  experience  is  discussed  in 
Cruickshank  (1984  and  1987)  for  software  in  the  CMS-2  language  developed  at  IBM  in  Manassas. 
Virginia.  Cruickshank  (1984)  gives  the  values  of  the  cost  of  reusing  software  relative  to  developing  new 
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software  of  0.25  for  modified  reused  code  and  0.03  for  unmodified  reused  code.  Cruickshank  (1987) 
also  gives  revised  values  of  0.31  and  0.04  for  the  same  reuse  types. 

The  principal  element  of  cost  in  reusing  code  is  that  of  testing  the  reused  code  in  the  presence  of  the  new 
code.  The  cost  of  reusing  code  may  also  include  the  costs  of  revising  existing  test  plans  and  procedures. 
Further,  the  cost  of  reusing  code  can  include  the  cost  of  determining  what  code  units  are  appropriate 
to  reuse  from  the  reuse  library  or  other  source.  Using  the  data  in  Table  2-2  and  assuming  that  the  cost 
of  reusing  code  is  the  cost  of  the  activities  of  software  integration  test  and  acceptance  test,  you  can 
calculate  the  cost  ratio  of  reusing  code  to  developing  new  code  as  (1.500  +  0.250)/8.460  =  0.21.  Similarly, 
using  the  data  in  Table  2-3  and  assuming  that  the  cost  of  reusing  code  is  the  cost  of  computer  software 
component  (CSC)  integration  test  and  computer  software  configuration  item  (CSCI)  test,  you  can  de¬ 
termine  the  cost  ratio  of  reusing  code  to  developing  new  code  as  (1.60+  1.55)/10.00  =  0.315.  These 
ratios  are  in  the  same  range. 

The  default  value  of  Cvr  in  the  tool  is  0.5  LM/KSLOC,  which  is  one-tenth  of  the  default  value  of  the 
unit  cost  of  new  code,  i.e.,  Cvr  =  0.10  •  Cvn  =  (0.1X5.00)  =  0.5  LM/KSLOC.  This  is  the  value  used 
in  Section  4.  Without  any  other  information,  you  can  use  a  value  of  2.0  (0.2  •  10.00)  LM/KSLOC  for 
Cvr 

2.5.3  Selecting  a  Valle  of  Cde 

You  can  estimate  the  unit  cost  of  domain  engineering.  Cde-  as  a  proportion  of  the  unit  cost  of  developing 
new  code,  Cvn-  This  proportion  can  be  expected  to  be  in  the  range  of  1.50  to  2.00,  and  the  value  of 
1.50  can  be  used  if  there  is  no  other  experience  data  available  to  the  user  of  the  tool.  Margono  and  Rhoads 
(1992)  suggest  a  value  of  2.00  for  the  ratio  of  Cde  to  Cvn- 

You  should  estimate  the  value  of  Cqe  based  on  your  assessment  of  the  nature  of  the  process  that  will 
be  employed  to  develop  reusable  components.  If  this  process  does  not  differ  appreciably  from  that 
employed  to  develop  new  code  that  is  not  specifically  reusable,  then  the  value  of  Cde  would  not  be 
much  greater  than  Cvn-  However,  if  extra  effort  is  required  to  make  the  code  reusable,  the  Cde  value 
should  be  noticeably  greater  than  that  for  Cvn-  perhaps  up  to  2.0  •  Cvn-  Note  that  the  size  of  the 
library  is  symbolized  by  Sj  (see  Sections  A. 2.2  and  A. 2.3  for  more  information  about  how  to  define 
the  size  of  the  library).  Therefore,  Cde  *  S  r  is  the  cost  of  developing  the  reuse  program,  which  includes 
various  items,  such  as  developing  reuse  program  goals,  identifying  strategies,  forecasting  the  number 
of  systems  that  will  include  RSOs  from  the  library,  and  creating  the  RSOs.  The  Reuse  Adoption  Guide¬ 
book  (Software  Productivity  Consortium  1992a)  provides  more  information  about  the  establishment 
of  a  reuse  program. 

The  default  value  of  Cde  used  >n  the  Reuse  Economics  Spreadsheet  Model  is  7.5  LM/KSLOC.  which 
is  1.5  times  the  default  value  of  Cvn- i-e.  Cde  =  L5-CVn  =  (1.5X5.00)  =  7.5  LM/KSLOC.  This  is 

the  value  used  in  Section  4.  Without  any  other  information,  you  can  use  a  value  of  b  n  < !  5  •  10.00) 
LM/KSLOC  for  CDe- 
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The  Consortium  has  provided  the  Reuse  Economics  Spreadsheet  Model  tool  as  a  set  of  Microsoft 
Excel  files  and  executable  files  on  a  diskette.  The  tool  will  operate  on  either  a  Macintosh  or  an  IBM- 
compatible  PC.  The  files  named  ModeXDB.xls  are  likely  to  change  in  size  over  time.  They  grow  or 
shrink  in  proportion  to  the  number  of  worksheet  rows.  A  prerequisite  for  the  operation  of  the  tool 
is  to  have  version  4.0  of  Microsoft  Excel  installed  on  your  computer. 

Microsoft  Excel  retains  a  list  of  recently  opened  files  that  displays  in  the  File  Menu.  Do  not  try  to  open 
the  Reuse  Economics  Spreadsheet  Model  tool  from  this  list.  Attempting  to  open  the  tool  from  the 
recently  opened  list  may  result  in  the  error  message  “Cannot  find  MenuBars.xlm.”  To  recover  from 
this  error,  click  the  [OK]  button.  A  Macro  Error  Dialog  Box  appears.  Click  the  [Halt]  button.  Then 
select  Quit  from  the  File  Menu. 

3.1  INSTRUCTIONS  FOR  THE  MACINTOSH  VERSION  OF  THE  REUSE  ECONOMICS 
SPREADSHEET  MODEL  TOOL 

3.1.1  Recommended  Configuration 

The  recommended  configuration  for  running  the  Macintosh  version  of  the  Reuse  Economics  Spreadsheet 
Model  tool  is: 

•  A  Macintosh  capable  of  running  Microsoft  Excel,  version  4.0 

•  4  megabytes  of  RAM 

•  Macintosh  system  software,  version  6.0.2  or  later 

•  Finder,  version  6.1  or  later 

•  Microsoft  Excel,  version  4.0 

•  Enough  space  on  the  hard  disk  for  the  Reuse  Economics  Spreadsheet  Model  files  (758  kilobytes) 

3.1.2  Installing  the  Software  on  a  Hard  Disk 

To  copy  the  contents  of  the  diskette  to  your  hard  disk,  perform  the  following  steps: 

•  Place  the  diskette  containing  the  Reuse  Economics  Spreadsheet  Model  tool  in  the  disk  drive. 

•  Open  the  diskette  by  double-clicking  on  the  diskette  icon. 

•  Copy  the  RESSM  folder  by  clicking  on  the  folder  icon  and  dragging  it  to  the  hard  drive  icon. 
Release  the  mouse  button  to  start  the  copy  procedure.  The  contents  of  the  folder  are  placed 
in  a  folder  named  RESSM. 
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3.13  Running  the  Reuse  Economics  Spreadsheet  Model  Tool 

3.13.1  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool  From  a  Diskette 

To  invoke  the  Reuse  Economics  Spreadsheet  Model  tool  from  a  diskette,  perform  the  following  steps: 

•  Make  sure  you  have  read-write  access  to  the  diskette. 

•  Place  the  diskette  containing  the  Reuse  Economics  Spreadsheet  Model  tool  in  the  disk  drive. 

•  Open  the  diskette  by  double-clicking  on  the  diskette  icon.  A  window  displaying  the  diskette 
contents  appears. 

•  Open  the  RESSM  folder  by  double-clicking  on  the  folder  icon.  A  window  displaying  the  folder 
contents  appears. 

•  Start  the  RESSM  application  by  double-clicking  on  the  file  RESSMBgn.xlm.  The  Reuse 
Economics  Spreadsheet  Model  tool  Start  window  appears. 

3.13.2  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool  From  a  Hard  Disk 

To  invoke  the  Reuse  Economics  Spreadsheet  Model  tool  from  a  hard  disk,  perform  the  following  steps: 

•  Open  the  hard  drive  by  double-clicking  on  the  hard  drive  icon.  A  window  displaying  the  hard 
drive  contents  appears. 

•  Open  the  RESSM  folder  by  double-clicking  on  the  folder  icon.  A  window  displaying  the  folder 
contents  appears. 

•  Start  the  RESSM  application  by  double-clicking  on  the  file  RESSMBgn.xlm.  The  Reuse 
Economics  Spreadsheet  Model  tool  Start  window  appears. 

Operation  of  the  tool  is  described  in  Section  4. 

3.2  INSTRUCTIONS  FOR  THE  PC  VERSION  OF  THE  REUSE  ECONOMICS 
SPREADSHEET  MODEL  TOOL 


3.2.1  Recommended  Configuration 

The  recommended  configuration  for  running  the  PC  version  of  Reuse  Economics  Spreadsheet  Model 
tool  is: 

•  An  IBM-compatible  PC  capable  of  running  Microsoft  Excel,  version  4.0 

•  4  megabytes  of  RAM 

•  MS-DOS,  version  3.3  or  greater 

•  Microsoft  Windows,  version  3.0  or  greater 
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•  Microsoft  Excel,  version  4.0 

•  Enough  space  on  the  hard  disk  for  the  Reuse  Economics  Spreadsheet  Model  files  (821  kilobytes) 

3.2.2  Installing  the  Software  on  a  Hard  Disk 

To  copy  the  contents  of  the  diskette  to  your  hard  disk,  perform  the  following  steps: 

•  Create  a  subdirectory  under  the  Excel  directory  (C  >  mkdir  \excel\ressm). 

•  Copy  all  files  from  the  diskette  to  the  RESSM  directory  you  created. 

Note:  You  should  not  place  the  files  in  a  separate  subdirectory  from  the  Microsoft  Excel  files. 

•  From  the  Program  Manager  Menu,  select  the  program  group  in  which  to  place  RESSM  and 
then  select  the  File  and  New  options.  A  property  sheet  appears. 

•  Verify  that  you  have  selected  the  program  item  and  then  click  the  [OK]  button.  The  Program 
Item  Properties  dialog  box  appears. 

•  In  the  Description  field,  type  RESSM,  then  press  the  <  TAB  >  key  or  move  the  mouse  to  the 
command  line  field. 

•  In  the  Command  line  field,  type  C:\excel\ressm\ressmbgn.xlm  and  press  <  RETURN  >  or 
click  the  [OK]  button. 

•  In  the  working  directory  field,  type  C:\excel\ressm. 

•  If  you  would  like  to  replace  the  icon,  select  the  [Change  Icon]  button  before  you  click  the  [OK] 
button  or  press  <  RETURN  > .  Then  enter  the  full  path  name  containing  the  icon  file.  If  you 
do  not  want  to  change  your  icon  and  accept  the  default  icon,  click  the  [OK]  button. 

Installation  of  the  Reuse  Economics  Spreadsheet  Model  tool  on  your  hard  disk  is  now  complete. 

3.2.3  Running  the  Reuse  Economics  Spreadsheet  Model  Tool 

3.2.3. 1  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool  From  a  Diskette 

To  invoke  the  Reuse  Economics  Spreadsheet  Model  tool  from  a  diskette,  perform  the  following  steps: 

•  Make  sure  you  have  read-write  access  to  the  diskette. 

•  Double-click  on  the  Microsoft  Excel  icon  to  start  Microsoft  Excel. 

•  Select  the  File  and  Open  options. 

•  In  the  directories  list  box,  select  the  drive  where  you  have  inserted  the  floppy  and  click  the 
[OK]  button.  The  files  contained  on  the  floppy  now  display  in  the  files  list  box. 

•  Select  RESSMBGN.XLM  and  click  the  [OK]  button.  The  software  loads  and  the  opening 
screen  displays  with  the  File  and  Modes  pull-down  menus. 

Operation  of  the  tool  is  described  in  Section  4. 
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3. 2.3. 2  Invoking  the  Reuse  Economics  Spreadsheet  Model  Tool  From  a  Hard  Disk 

To  invoke  the  Reuse  Economics  Spreadsheet  Model  tool  from  a  hard  disk,  double-click  the  RESSM 
icon.  The  software  loads,  and  the  opening  screen  displays  with  the  File  and  Modes  pull-down  menus. 

Operation  of  the  tool  is  described  in  Section  4. 

3.3  LIST  OF  FILES  INCLUDED  IN  THE  MACINTOSH  VERSION  OF  THE  REUSE 
ECONOMICS  SPREADSHEET  MODEL  TOOL 


CompCOM 

MlaExt4jds 

M3Form.xlm 

Mode2DB.xls 

CompISP 

MlaExt5.xls 

M3Grafs.xlm 

Mode3.xlw 

CompNiSS 

MlaForm.xlm 

M4Form.xlm 

Mode3DB.xls 

CompSSi 

MlaGrafs.xlm 

MenuBars.xlm 

Mode4jdw 

CompSTl 

MlbForm.xlm 

Modela.xlw 

Mode4DB.xls 

CompSTi 

M2Extl.xls 

ModelaDB.xls 

MlaExtl.xls 

M2Form.xlm 

Modelb.xlw 

RESSMBgnjdm 

MlaExt2.xls 

M2Grafs.xlm 

ModelbDB.xls 

RESSMLog.xls 

MlaExt3.xls 

M3Extl.xls 

Mode2.xlw 

RESSMLog.xlw 

LIST  OF  FILES  INCLUDED  IN  THE  PC  VERSION  OF  THE  REUSE  ECONOMICS 
SPREADSHEET  MODEL  TOOL 

COMPCOM.DLL 

M1AEXT4.XLS 

M3FORM.XLM 

MODE2DB  XLS 

COMPISP.DLL 

M1AEXT5.XLS 

M3GRAFS.XLM 

MODE3.XLW 

COMPNISS.DLL 

M1AFORM.XLM 

M4FORM.XLM 

MODE3DB.XLS 

COMPSSI.DLL 

MLAGRAFS.XLM 

MENUBARS.XLM 

MODE4.XLW 

COMPSTl.DLL 

M1BFORM.XLM 

MODE1A.XLW 

MODE4DB.XLS 

COMPSTI.DLL 

M2EXT1.XLS 

M0DE1ADB.XLS 

RFSSMBGN.XLM 

M1AEXT1.XLS 

M2FORM.XLM 

MODE1B.XLW 

M1AEXT2.XLS 

M2GRAFS.XLM 

M0DE1BDB.XLS 

RESSMLOG.XLS 

M1AEXT3.XLS 

M3EXT1.XLS 

MODE2.XLW 

RESSMLOG.XLW 

4.  OPERATING  THE  TOOL 


4.1  USER  INTERFACE  CONVENTIONS 

The  Reuse  Economics  Spreadsheet  Model  tool  uses  standard  Microsoft  Excel  interface  conventions 
whenever  possible.  The  tool  provides  custom  menus  to  protect  you  from  inadvertently  modifying  the 
application.  It  also  provides  a  user-friendly  interface  to  those  not  well  versed  in  using  Microsoft  Excel. 
For  more  detailed  information  about  standard  Microsoft  Excel  interface  conventions,  please  refer  to 
the  Microsoft  Excel  User’s  Guide  (Microsoft  1991). 

Note :  Due  to  the  incompatibility  between  this  and  previous  versions  of  the  tool,  any  existing  data 
from  previous  versions  will  need  to  be  reentered  for  use  in  version  3. 

This  section  provides  a  brief  description  of  the  user  interface  conventions  that  the  tool  uses.  It  also 
provides  examples  of  using  the  tool,  including  creating  graphs  of  data  that  you  provide  and  that  the 
tool  calculates. 

Figure  4-1  provides  a  menu  hierarchy  for  the  Reuse  Economics  Spreadsheet  Model  tool’s  available 
functionality. 

4.1.1  Selecting  From  Menus 

Make  a  menu  selection  by  holding  down  the  mouse  button  and  dragging  the  mouse  over  the  menu 
selections  until  you  highlight  your  desired  choice.  Release  the  mouse  button  on  the  selected  option 
to  execute  your  choice. 

4.1.2  Activating  a  Window 

Activate  a  window  by  clicking  the  mouse  anywhere  in  the  window.  The  title  bar  of  a  window  contains 
stripes  when  that  window  is  active. 

4.1.3  Menu  Bars  and  Active  Windows 

The  menu  bar  displayed  corresponds  to  the  appropriate  type  of  menu  bar  for  the  active  window.  The 
striped  title  bar  indicates  the  active  window. 

4.1.4  Closing  the  Active  Window 

Close  the  active  window  by  clicking  the  mouse  button  on  the  Close  box  in  the  upper  left  corner  of  the 
window  or  choose  the  Close  operation  from  the  File  menu  (see  Sections  4.4.1,  4.5.1,  and  4.6.1). 
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4.1.5  Sizing  the  Active  Window 

Use  standard  mouse  techniques  to  size  and  move  windows.  To  change  the  size  of  a  window',  select  a 
corner  edge  and  drag  the  mouse  to  the  desired  location.  To  move  a  window,  select  a  noncorner  portion 
of  a  window  and  drag  the  mouse  to  the  desired  location. 
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4.1.6  Scrolling  the  Active  Window 

The  tool  provides  both  horizontal  and  vertical  scroll  bars  to  scroll  windows. 


4.2  THE  START  WINDOW 

The  Start  window  appears  when  you  stait  the  system  (see  Figure  4-2).  It  provides  access  to  the  Main 
window. 
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Begin 


End 


Figure  4-2.  Start  Window 

The  Start  window  consists  of  three  parts:  a  static  text  area,  two  buttons,  and  a  custom  Microsoft  Excel 
menu  bar.  The  static  text  area  displays  the  Consortium  logo  and  the  tool  name.  The  [Begin]  and  [End] 
buttons  axe  used  to  start  or  stop  the  tool: 

•  Clicking  the  [Begin]  button  causes  the  Main  window  to  be  displayed. 

•  Clicking  the  (End]  button  terminates  the  tool. 

The  menu  bar  contains  two  menus  named  File  and  Modes.  The  menu  bar  entries  are  disabled  in  the 
Start  window.  They  become  enabled  in  the  Main  window. 

4.3  THE  MAIN  WINDOW 

The  Main  window  is  the  window  that  appears  after  clicking  the  [Begin]  button  on  the  Start  window 
(see  Figure  4-3).  It  provides  access  to  all  system  functions. 
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Figure  4-3.  Main  Window 

The  Main  window  consists  of  a  custom  Microsoft  Excel  menu  bar.  The  menu  bar  contains  three  menus 
named  File,  Modes,  and  Window. 

4.3.1  The  File  Menu 

The  File  menu  allows  you  to  exit  the  system.  To  exit,  select  Quit  from  the  File  menu.  Quit  exits  both 
the  application  and  Microsoft  Excel. 

4.3.2  The  Modes  Menu 

The  Modes  menu  allows  you  to  choose  one  of  the  following  ies  of  operation  defined  for  the  tool: 

•  Mode  la:  Basic  Model— Reuse  With  Up-Front  Reuse  Program  Investment 

•  Mode  lb:  Intraproject  Reuse 

•  Mode  2:  Incremental  Reuse  Program  Investment  Without  Cost  of  Money 

•  Mode  3:  Incremental  Reuse  Program  Investment  With  Cost  of  Money 

•  Mode  4:  Basic  Model  Plus  Reuse  of  Requirements  and/or  Design 

To  choose  a  reuse  model,  select  one  of  the  modes  listed  in  the  Modes  menu.  This  version  of  the  tool 
supports  only  Modes  la,  2,  and  3. 

•  Selecting  Basic  Model— Reuse  With  Up-Front  Reuse  Program  Investment  results  in  the 
presentation  of  the  Mode  la  window.  This  mode  assumes  that  all  of  the  application  systems 
that  make  up  a  family  have  the  same  parameter  values  for  Proportion  of  Code  Reuse,  Unit 
Cost  of  Reuse  Program  Investment,  Unit  Cost  of  New  Code,  Unit  Cost  of  Reused  Code,  Size 
of  Reuse  Library,  Average  Size  of  Application  System,  and  Relative  Library  Capacity.  The 
model  implements  each  family  as  a  single  row  of  the  Mode  la  worksheet. 

•  Selecting  Incremental  Reuse  Program  Investment  Without  Cost  of  Money  results  in  the 
presentation  of  the  Mode  2  window.  This  mode  assumes  that  each  of  the  application  systems 
that  make  up  a  family  may  have  unique  parameter  values  for  Unit  Cost  of  New  Code.  Unit 
Cost  of  Reused  Code,  Size  of  Reuse  Library,  and  Size  of  Application  System.  The  model  imple¬ 
ments  each  family  as  a  contiguous  group  of  rows  of  the  Mode  2  worksheet.  All  of  the  rows 
of  a  family  are  identified  by  a  common  family  number. 

•  Selecting  Incremental  Reuse  Program  Investment  With  Cost  of  Money  results  in  the  presentation 
of  the  Mode  3  window.  This  mode  assumes  that  each  of  the  application  systems  that  make 
up  a  family  may  have  unique  parameter  values  for  Unit  Cost  of  New  Code.  Unit  Cost  of 
Reused  Code.  Size  of  Reuse  Library,  and  Size  of  Application  System.  Tire  model  implements 
each  family  as  a  contiguous  group  of  rows  of  the  Mode  3  worksheet.  Ail  of  the  rows  of  a  family 
are  identified  by  a  common  family  number. 
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Figure  4-4.  Arrange  All  Window 


4.  Operating  the  Too! 


4.4  THE  MODE  la  WINDOW 

The  Mode  la  window  appears  when  you  select  Basic  Model— Reuse  Program  Investment  With  Up-Front 
Reuse  Program  Investment  from  the  Modes  menu  of  the  Main  window.  It  provides  access  to  all  other 
system  functions  for  Mode  la  operation.  The  window  consists  of  a  custom  menu  bar  and  a  Microsoft 
Excel  worksheet  (see  Figures  4-5,  4-6,  and  4-7).  The  menu  bar  contains  the  File,  Family,  Graphs,  and 
Window  menus. 

The  worksheet  contains  the  rows  of  data  that  either  you  entered  or  were  computed  from  the  values 
you  entered.  Each  column  of  data  corresponds  to  a  variable  described  in  the  reuse  economics  model 
detailed  in  Cruickshank  and  Gaffney  (1991)  and  summarized  in  Appendix  A.  Table  4-1  shows  the 
mapping  of  column  names  to  variable  names. 

Note:  The  sample  data  sets  are  for  demonstration  purposes  only;  you  should  build  your  own. 
4.4.1  The  File  Menu 

The  File  menu  provides  the  following  options: 

•  Print  Preview 

-  To  print  the  worksheet,  select  Print  Preview  from  the  File  menu.  The  standard  Microsoft 
Excel  Print  Preview  window  then  appears. 

Note:  Attempting  to  print  when  there  is  no  printer  connected  may  result  in  a  macro  error. 
Should  this  happen,  click  the  mouse  on  the  [Halt]  button  to  return  to  normal  operation. 


Figure  4-5.  Mode  la  Window  (pari  1) 
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Figure  4-6.  Mode  la  Window  (part  2) 


Figure  4-7.  Mode  la  Window  (part  3) 
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Table  4-1.  Mapping  of  Worksheet  Column  Names  to  Reuse  Economic  Model  Variable  Names 


Worksheet 

Column 

Label 

Worksheet  Column  Name 

Variable  Name* 

Constraints 

A 

Family  Number 

FamilyNo 

0  <  FamilyNo 

B 

Number  of  Application  Systems 

N 

0  <  N 

C 

Proportion  of  Code  Reuse 

R 

0  <  R  <  1 

D 

Unit  Cost  of  Reuse  Program 
Investment 

Cde 

0  <  Cr>E 

E 

Unit  Cost  of  New  Code 

Cvn 

0  <  Cvn 

F 

Unit  Cost  of  Reused  Code 

CvR 

0  <  CvR 

G 

Size  of  Reuse  Library 

ST 

0  <  ST  <  SS 

H 

Average  Size  of  Application 
System 

SS 

0  <  SS 

I 

Relative  Library  Capacity 

K 

K  =  ST/SS 

J 

Unit  Cost  of  Product 

Cusi 

Cus  =  [(CDE/N).K]  +  Cvn-[(Cvn-Cvr).R] 

K 

Cost  of  Product 

Cs 

Cs  =  Cus  *  SS 

L 

Application  Engineering  Cost 
per  Svstem 

C/Vi 

M 

Reuse  Program  Investment 
Cost  per  System 

CoEiSumTermsl 

Cus  •  SS  -  CA 

N 

Reuse  Program  Investment 

CdbST 

cdest  =  Cde.ST 

O 

Cost  per  System  With  All  New 
Code 

CT 

CT  =  Cvn  •  SS 

P 

Product  Productivity 

PU 

PU  =  1,000/Cus 

0 

Relative  Product  Productivity 

P 

P  =  Cvn/Cus 

R 

Relative  Product  Cost 

C 

C  =  1/P 

S 

Rr’  tive  Reuse  Cost 

CvRR 

CvRR  =  Cvr/Cvn 

T 

Breakeven  Number  of  Systems 

No 

No  =  CDn/[(CvN-CVR).E] 

U 

Return  on  Investment 

ROI 

ROI  =  ((N/No)-  1)*  100 

V 

Library  Efficiency 

E 

E  =  R/K 

*  Appendix  A  and  Cruickshank  and  Gaffney  (1991)  use  subscripts  on  some  of  these  variables,  such  asCoj-  instead 
of  CDE  and  Cus  instead  of  CUS. 
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•  Save 

-  To  save  changes  made  to  the  worksheet,  select  Save  from  the  File  menu.  The  tool  saves 
the  data  and  returns  you  to  the  Mode  la  window.  Saving  a  worksheet  overwrites  the 
previous  data  with  the  current  data.  The  tool  maintains  only  one  version  of  the  worksheet 
and  makes  it  accessible  through  the  application. 

-  To  retain  old  data  indefinitely,  make  a  copy  of  the  file  ModelaDB.xls  under  a  new 
name.  Do  this  outside  of  the  Reuse  Economics  Spreadsheet  Model  tool. 

-  To  restore  old  data,  rename  a  saved  file  to  ModelaDBjds.  You  should  be  able  to  print 
a  saved  worksheet  from  Microsoft  Excel.  Saving  old  data  under  different  file  names 
is  a  way  to  preserve  historical  data  associated  with  a  particular  graph  or  set  of  graphs. 

•  Close 


-  To  exit  the  Mode  la  window,  select  Close  from  the  File  menu.  A  dialog  box  appears  to 
warn  you  if  you  have  any  unsaved  changes.  Click  the  l  Yes]  or  [No]  button,  as  appropriate, 
to  continue  the  Close  piocess. 

-  When  the  Close  process  completes,  the  Main  window  appears. 


4.4.2  Dialog  Box  Description 

The  Family  menu  operations  use  a  common  dialog  box  interface.  The  interface  for  Modify  operations 
consists  of  a  sequence  of  two  dialog  boxes.  The  interface  for  Add  and  Delete  operations  consists  of 
a  single  dialog  box  that  is  identical  to  the  second  dialog  box  displayed  for  a  Modify  operation. 

The  first  dialog  box  contains  a  check  box  for  each  of  the  modifiable  fields.  It  allows  you  to  specify 
which  fields  you  wish  to  modify,  thus  providing  protection  against  inadvertent  data  modification.  You 
must  select  the  check  boxes  for  those  fields  that  you  wish  to  modify.  Clicking  the  [OK]  button  causes 
the  next  dialog  box  in  the  sequence  to  be  displayed.  Clicking  the  [Cancel]  button  terminates  the  current 
operation  and  returns  control  to  the  Mode  la  window. 

The  second  dialog  box  contains  list  boxes  anci  number  edit  boxes.  It  allows  you  to  enter  data  and 
display  data  corresponding  to  a  selected  family.  The  fields  of  the  dialog  box  are  enabled  or  disabled 
in  accordance  with  the  type  of  operation  to  be  performed.  A  list  box  is  used  for  selecting  family  num¬ 
bers.  The  enabled  number  edit  boxes  are  used  for  entering  data  for  the  selected  family.  The  disabled 
number  edit  boxes  are  used  to  display  constraints  or  current  data  values  for  your  convenience.  Clicking 
the  [Refresh]  button  updates  the  screen  to  display  the  dialog  box  with  the  current  values  for  the 
selected  family  shown  in  the  number  edit  boxes.  Clicking  the  [Accept]  button  carries  out  the  current 
operation  and  returns  control  to  the  dialog  box.  Clicking  the  [Cancel]  button  terminates  the  current 
operation  and  returns  f'ontrol  to  the  Mode  la  window. 

The  fields  that  are  modifiable  include: 

•  N.  This  field  corresponds  to  the  Number  of  Application  Systems  in  the  family. 

•  K.  This  field  corresponds  to  the  Proportion  of  Code  Reuse  for  all  members  of  the  family. 
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•  CDE.  This  field  corresponds  to  the  Unit  Cost  of  Reuse  Program  Investment.  All  applications 
within  a  family  have  the  same  value  for  CDE.  Due  to  an  implementation  constraint  that  requires 
a  nonzero  value  for  CDE,  it  is  not  possible  to  exactly  model  the  situation  where  there  is  no  Reuse 
Program  Investment  (i.e.,  you  are  reusing  library  components  that  have  been  supplied  to  you  at 
no  cost).  However,  you  can  approximately  model  that  situation  by  supplying  a  small  value 
(e.g„  0.001)  for  CDE.  This  may  cause  the  Return  on  Investment  field  to  display  a  value  too  large 
for  the  column  width.  Such  a  situation  is  indicated  by  the  presence  of  ###  instead  of  a  numeric 
value  in  the  worksheet  cell. 

•  CV TV.  This  field  corresponds  to  the  Unit  Cost  of  New  Code.  All  applications  within  a  family 
have  the  same  value  for  CVN. 

•  CVR.  This  field  corresponds  to  the  Unit  Cost  of  Reused  Code.  All  applications  within  a  family 
have  the  same  value  for  CVR. 

•  ST.  This  field  corresponds  to  the  Size  of  Reuse  Library. 

•  SS.  This  field  corresponds  to  the  Average  Size  of  the  Application  Systems  in  the  family. 

4.4.3  The  Family  Menu 

The  Family  menu  provides  the  following  options: 

•  Add  Family 

-  To  add  a  family: 

—  Select  Add  Family  from  the  Family  menu.  The  Add  Family  Dialog  Box  then 
appears  as  shown  in  Figure  4-8. 

—  Enter  parameter  values  in  the  fields  provided.  You  can  use  the  <TAB>  key 
to  sequentially  traverse  the  data  entry  fields  or  use  the  mouse  to  point  and  click 
on  the  fields  directly. 

—  Click  the  [Accept]  button  when  you  are  finished  modifying  data.  The  new  row 
will  be  added  to  the  end  of  the  existing  worksheet  data.  The  row  will  be  identi¬ 
fied  by  a  Family  Number  and  will  have  the  values  specified  for  the  input  fields. 

-  To  view  an  existing  family,  select  the  desired  Family  Number  from  the  Family  Number 
list  box,  and  click  the  [Refresh]  button.  The  data  for  the  selected  family  will  be  shown 
in  the  corresponding  dialog  box  fields. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Add  Family  operation  and  return 
control  to  the  Mode  la  window'. 

A7///.:  Pressing  <  RETURN  >  is  the  same  as  clicking  the  [Refresh]  button. 

ir.Yiw/./.:  7b  create  a  family  with  parameter  values  N  =  5.  R  =  0.3.  CDF  =  7.5.  CVN  =  5,  CVR  =  0.5, 

ST  =  30.  and  SS=  100: 
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—  Select  the  check  boxes  corresponding  to  those  values  that  are  to  be  modified. 

—  Click  the  [OK]  button  to  proceed  to  the  Mouify  Family  Dialog  Box2  as  shown 
in  Figure  4-10.  The  Modify  Family  Dialog  Box2  provides  the  means  to  modify 
a  row  representing  a  family. 

—  Select  the  corresponding  Family  Number  by  clicking  the  mouse  button  to 
highlight  the  number  in  the  Family  Number  list  box  of  the  Modify  Family 
Dialog  Box2.  Then  enter  those  values  that  you  wish  to  modify. 
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—  Clicking  the  [Accept]  button  will  modify  the  selected  family  and  return  control 
to  the  Modify  Family  Dialog  Box2. 

-  Clicking  the  [Refresh]  button  will  update  the  dialog  box  to  display  the  current  values 
for  the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Modify  Family  operation  and  return 
control  to  the  Mode  la  window. 


ass; . -»aig=ss555s  Modify  Family  Dialog  Boh2  - 


Family  Number 


O 

2 

3 

4 

O 

5 

N  It 


1 

0.3 

cm: 

i:  «n 

5 

ST 

ss 

30 

100 

CUR 

[tT? 


^__Refresh_J 
(  Accept  ] 

[  Cancel/EHit  ] 


Figure  4-10.  Mode  la— Modify  Family  Dialog  Box2 
Example:  To  modify  a  family  to  set  parameters  N  =  6.  CVR  =  1.5,  and  ST  =  50: 

1.  Select  Modify  Family  from  the  Family  menu  to  display  the  Modify  Family  Dialog  Boxl. 

2.  Select  the  check  boxes  for  N,  CVR,  and  ST  (as  shown  in  Figure  4-9).  Make  sure  the  check  boxes 
for  nonmodifiable  fields  are  deselected. 


3.  Click  the  [OK]  button  to  proceed  to  the  Modify  Family  Dialog  Box2  (as  shown  in  Figure  4-10). 

4.  Select  the  Family  Number  for  the  family  that  you  wish  to  modify. 
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5.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family. 

6.  Enter  the  new  values  for  N,  CVR,  and  ST  in  the  appropriate  fields. 

7.  Click  the  [Accept]  button  to  modify  the  selected  family. 

8.  Click  the  [Cancel]  button  to  terminate  the  Modify  Family  operation. 

•  Delete  Family 

-  To  delete  a  family: 

—  Select  Delete  Family  from  the  Family  menu.  The  Delete  Family  Dialog  Box 
then  appears  as  shown  in  Figure  4-11. 

—  Select  the  corresponding  Family  Number  by  clicking  the  mouse  button  to 
highlight  the  number  in  the  Family  Number  list  box. 

—  Clicking  the  [Accept]  button  will  cause  the  Delete  Confirmation  Dialog  Box 
to  be  displayed  (see  Figure  4-12). 

—  Click  the  [OK]  button  if  you  wish  to  proceed  with  the  delete  operation.  The 
row  of  the  selected  family  will  be  deleted  and  the  remaining  worksheet  data 
will  be  renumbered  to  reflect  the  number  of  different  families  represented  in 
the  worksheet.  Click  the  [Cancel]  button  if  you  wish  to  abort  the  delete  operation. 

-  Clicking  the  [Refresh]  button  will  update  the  dialog  box  with  the  current  values  for 
the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Delete  Family  operation  and  return 
control  to  the  Mode  la  window. 


Figure  4-11.  Mode  la— Delete  Family  Dialog  Box 


Example-.  To  delete  a  family: 

1.  Select  Delete  Family  from  the  Family  menu  to  display  the  Delete  Family  Dialog  Box  (as  shown 
in  Figure  4-11). 


4-13 


4.  Operating  ihe  Tool 


A 

Rre  you  sure  you  urant 
to  delete  this  item  ? 

ii  ok  a 

[  Cancel  ] 

Figure  4-12.  Delete  Confirmation  Dialog  Box 


2.  Select  the  Family  Number  for  the  family  that  you  wish  to  delete. 

3.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family  (just  to  make 
sure  that  you  have  selected  the  correct  family). 

4.  Click  the  [Accept]  button  to  proceed  to  the  Delete  Confirmation  Dialog  Box  (as  shown  in 
Figure  4-12). 

5.  Click  the  [OK]  button  in  the  Delete  Confirmation  Dialog  Box  to  delete  the  selected  family  and 
display  the  Delete  Family  Dialog  Box. 

6.  Click  the  [Cancel]  button  in  the  Delete  Family  Dialog  Box  to  terminate  the  Delete  Family 
operation. 


4.4.4  The  Graphs  Menu 


The  Graphs  menu  generates  built-in  graphs  for  Mode  la  calculations.  A  series  of  dialog  boxes  appear 
when  you  select  a  graph  from  the  Graphs  menu.  These  input  dialog  boxes  allow  you  to  specify  the 
options  to  apply  to  the  selected  graph.  They  are  specific  to  each  graph  selection.  In  general,  the  dialog 
boxes  request  input  such  as  the  number  of  curves  to  plot  and  values  to  use  as  selection  criteria  when 
extracting  the  data  to  plot. 

Each  dialog  box  has  option  buttons  or  list  boxes  from  which  you  select  input  data  values.  Each  dialog 
box  also  has  an  [OK]  button  and  a  [Cancel]  button.  Click  the  [OK]  button  to  transmit  the  input  values 
to  the  application  and  continue  building  the  graph. 

Note:  Pressing  <  RETURN  >  in  response  to  a  dialog  box  is  the  same  as  clicking  the  [OK]  button. 

Click  the  [Cancel]  button  to  terminate  the  graph  build  operation.  See  Section  NO  TAG  for  more  de¬ 
tails  about  the  Mode  la  graphs. 

To  produce  a  graph  from  the  worksheet  data,  select  the  desired  graph  from  the  Graphs  menu.  There 
are  five  built-in  graphs  that  you  can  produce  in  Mode  la: 

•  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse 

•  Relative  Product  Productivity  vs  Relative  Reuse  Cost 

•  Product  Productivity  vs  Number  of  Application  Systems 


•  Return  on  Investment  vs  Number  of  Application  Systems 

•  Labor  Months  vs  Number  of  Application  Systems 
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4.4.4.1  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  Graph 

The  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  graph  provides  up  to  three  graphs 
of  relative  productivity  (productivity  for  the  development  of  a  product  consisting  of  both  new  and 
reused  code  relative  to  productivity  using  only  new  code)  as  a  function  of  the  proportion  of  code 
reused.  The  three  graphs  differ  with  respect  to  the  number  of  uses  (N)  employed. 

Note :  You  should  ensure  that  all  of  the  points  plotted  use  the  same  values  for  the  unit  costs  of  reuse 
program  investment  (Cde).  new  code  (Cvn)>  an<3  reusing  code  (Cvr). 

One  dialog  box  appears  for  entering  your  data  (shown  in  Figure  4-13). 


Number  of  curues  to  plot 


Ot 

02 

<8)3 


t .  n  i 

[  Cancel  ] 


Number  of  Rpplication  Systems  for  : 

Curue  1  Curue  2  Curue  3 


Select  Library  Efficiency  for  all  curues 


Figure  4-13.  Mode  la— Graphl  Inputs  Dialog  Box 


The  Graphl  Inputs  Dialog  Box  requests  a  value  for  the  number  of  curves  to  plot,  the  number  of 
application  systems  for  each  of  the  curves,  and  the  library  efficiency  to  use  in  all  plots. 


•  To  specify  a  value  for  the  number  of  curves  to  plot,  select  the  appropriate  option  button. 

•  To  specify  the  values  for  the  number  of  application  systems  for  each  curve,  select  a  value  from 
the  list  box  corresponding  to  each  desired  curve. 

•  To  specify  a  value  for  the  library  efficiency,  select  a  value  from  the  corresponding  list  box. 

•  To  have  the  selected  inputs  accepted  by  the  application,  click  the  [OK]  button  and  the  graph 
build  operation  will  continue. 
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•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to 
the  Mode  la  window. 


Note:  List  boxes  display  only  values  that  exist  for  the  appropriate  fields  in  the  ModelaDBjds  worksheet. 
When  you  complete  your  data  entries,  the  graph  window  displays  the  graph  (see  Figure  4-14). 


Figure  4-14.  Mode  la— Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  Graph  Window 

Table  4-2  shows  the  input  data  values  that  produced  the  graph  in  Figure  4-14. 


Table  4-2.  Input  Data  Values  for  Relative  Product  Productivity  vs 
Proportion  of  Code  Reuse  Graph  Window 


Number  of 
Application 
Systems 
(N) 

Proportion  of 
Code  Reuse 
(R) 

Unit  Cost  of 
Reuse  Program 
Investment 
(Cde) 

Unit  Cost  of 
New  Code 
(Cvn) 

Unit  Cost  of 
Reused  Code 
(Cvr) 

Relative 

Library 

Capacity 

(K) 

1 

0.3 

7.5 

5 

0.5 

0.3 

1 

0.5 

7.5 

5 

0.5 

0.5 

1 

0.7 

7.5 

5 

0.5 

0.7 

2 

0.3 

7.5 

5 

0.5 

0.3 

2 

0.5 

7.5 

5 

0.5 

0.5 

2 

0.7 

7.5 

5 

0.5 

0.7 

3 

0.3 

7.5 

5 

0.5 

0.3 

3 

0.5 

7.5 

5 

0.5 

0.5 

3 

0.7 

7.5 

5 

0.5 

0.7 
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Example:  The  data  for  each  curve  is  selected  based  on  the  values  you  specify  for  the  Number  of 
Application  Systems  (N)  and  the  Library  Efficiency  (E).  Using  the  dialog  box  shown  in  Figure  4-13, 
the  first  curve  will  display  a  point  for  each  row  in  the  ModelaDB.xls  worksheet  (see  Figures  4-5,  4-6, 
and  4-7)  with  N  =  1  and  E  =  1.  Similarly,  the  second  curve  will  display  a  point  for  each  row  in  the 
ModelaDB.xls  worksheet  (see  Figures  4-5,  4-6,  and  4-7)  with  N  =  2  and  E  =  1.  The  data  displayed  in 
Table  4-2  shows  a  set  of  three  points  for  each  curve.  The  first  point  is  represented  by  the  rows  with 
Proportion  of  Code  Reuse  (R)  =  0.3  and  Relative  Library  Capacity  (K)  =  0.3.  The  second  point  of  each 
curve  has  R  =  0.5  and  K  =  0.5.  The  third  point  of  each  curve  has  R  =  0.7  and  K  =  0.7.  In  each  case,  you 
will  notice  that  R  =  K.  This  forces  the  value  for  Library  Efficiency  to  equal  1.  Thus,  we  get  the  desired 
display.  This  graph  displays  the  effect  on  Relative  Product  Productivity  (P)  of  varying  R  as  N  increases 
(assuming  that  maximal  reuse  of  code  is  occurring  and  holding  other  parameters  constant).  To  gener¬ 
ate  the  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  Graph  for  Number  of  Application 
Systems  =  1,  2,  and  3  with  Library  Efficiency  =  1: 

1.  Scan  your  data  to  be  sure  that  it  does  not  contain  extra  rows  that  match  your  intended  selection 
criteria  but  are  not  meant  to  be  plotted  (e.g.,  you  might  have  a  row  with  N  =  1,  CDE=  15, 
CVN  =  10.  CVR  =  1.  and  E  =  1,  which  is  not  comparable  to  the  data  shown  above  because  the 
unit  costs  are  not  the  same).  If  such  data  exists,  eliminate  it  from  selection  by  temporarily 
modifying  its  value  for  the  selection  criteria  (e.g.,  you  could  set  N  =  10  to  eliminate  it  from 
selection). 

2.  Select  Relative  Product  Productivity  vs  Proportion  of  Code  Reuse  from  the  Graphs  menu  to 
display  the  Graphl  Inputs  Dialog  Box  (as  shown  in  Figure  4-13). 

3.  Select  Number  of  curves  to  plot  =  3. 

4.  Select  Number  of  Application  Systems  for  Curve  1  =  1. 

5.  Select  Number  of  Application  Systems  for  Curve  2  =  2. 

6.  Select  Number  of  Application  Systems  for  Curve  3  =  3. 

7.  Select  Library  Efficiency  for  all  curves  =  1. 

8.  Click  the  [OK]  button  in  the  Graphl  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 
data  (as  shown  in  Figure  4-14). 

4.4.4.2  Relative  Product  Productivity  vs  Relative  Reuse  Cost  Graph 

The  Relative  Product  Productivity  vs  Relative  Reuse  Cost  graph  provides  up  to  three  graphs  of  relative 
productivity  (as  defined  earlier)  as  a  function  of  the  unit  cost  of  reusing  code  (C\r)  relative  to  the  unit 
cost  of  creating  new  code  (Cvn).  This  relative  cost,  Cvrr.  is  given  by  the  formula  Cvrr  =  Cvr /Cvn- 
The  three  graphs  differ  with  respect  to  the  values  of  R.  the  proportion  of  code  reuse,  that  you  select. 

Note:  You  should  ensure  that  all  of  the  points  plotted  use  the  same  values  for  the  unit  costs  of  reuse 
program  investment  (Coe)  and  new  code  (Cvn). 

Two  dialog  boxes  appear  for  entering  your  data  (show'n  in  Figures  4-15  and  4-16). 

The  Graph2A  Inputs  Dialog  Box  requests  values  for  the  number  of  curves  to  plot  and  the  proportion 
of  code  reuse  for  each  curve. 

•  To  specify  a  value  for  the  number  of  curves  to  plot,  select  the  appropriate  option  button. 
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4.  Operating  the  Tool 


Figure  4-15.  Mode  la— Graph2A  Inputs  Dialog  Box 


Proportion  of  Code  Rouse 
Cuive  }  i:uroo2  1  urur  3 


Figure  4-16.  Mode  la— Graph2B  Inputs  Dialog  Box 


•  To  specify  the  values  for  the  proportion  of  code  reuse  for  each  curve,  select  a  value  from  the 
list  box  corresponding  to  each  desired  curve. 


To  have  the  selected  inputs  accepted  by  the  application,  click  the  [OK]  button  and  the 
Graph2B  Inputs  Dialog  Box  will  be  displayed. 


4.  Operating  the  Tool 


•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to 
the  Mode  la  window. 

The  Graph2B  Inputs  Dialog  Box  displays  the  selected  values  from  the  Graph2A  Inputs  Dialog  Box 
and  requests  values  for  the  number  of  application  systems  for  all  curves  and  the  library  efficiency  to 
use  in  all  plots. 

•  To  specify  a  value  for  the  number  of  application  systems,  select  a  value  from  the  corresponding 
list  box. 

•  To  specify  a  value  for  the  library  efficiency,  select  a  value  from  the  corresponding  list  box. 

•  To  have  the  selected  inputs  accepted  by  the  application,  click  the  [OK]  button  and  the  graph 
build  operation  will  continue. 

•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to 
the  Mode  la  window. 

Note:  List  boxes  display  only  values  that  exist  for  the  appropriate  fields  in  the  ModelaDB.xls  worksheet. 
When  you  complete  your  entries,  the  graph  window  displays  the  resultant  graph  (see  Figure  4-17). 


Figure  4-17.  Mode  la— Relative  Product  Productivity  vs  Relative  Reuse  Cost  Graph  Window 
Table  4-3  shows  the  input  data  values  that  produced  the  graph  in  Figure  4-17. 
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4.  Operating  ihe  Tool 


Thble  4-3.  Input  Data  Values  for  Relative  Product  Productivity  vs 
Relative  Reuse  Cost  Graph  Window 


Number  of 
Application 
Systems 
(N) 

Proportion  of 
Code  Reuse 
(R) 

Unit  Cost  of 
Reuse  Program 
Investment 
(Cde) 

Unit  Cost  of 
New  Code 
(Cvn) 

Unit  Cost  of 
Reused  Code 
(Cvr) 

Relative 

Library 

Capacity 

(K) 

4 

0.35 

7.5 

5 

0.5 

0.35 

4 

0.75 

7.5 

5 

0.5 

0.75 

4 

0.95 

7.5 

5 

0.5 

0.95 

4 

0.35 

7.5 

5 

1.0 

0.35 

4 

0.75 

7.5 

5 

1.0 

0.75 

4 

0.95 

7.5 

5 

1.0 

0.95 

4 

0.35 

7.5 

5 

1.5 

0.35 

4 

0.75 

7.5 

5 

1.5 

0.75 

4 

0.95 

7.5 

5 

1.5 

0.95 

Example:  The  data  for  each  curve  is  selected  based  on  the  values  you  specify  for  the  Proportion  of  Code 
Reuse  (R),  Number  of  Application  Systems  (N),  and  the  Library  Efficiency  (E).  Using  the  dialog  boxes 
shown  in  Figures  4-15  and  4-16,  the  first  curve  will  display  a  point  for  each  row  in  the  ModelaDB.xls 
worksheet  (see  Figures  4-5,  4-6,  and  4-7)  with  R  =  0.35,  N  =  4,  and  E  =  1.  Similarly,  the  second  curve 
will  display  a  point  for  each  row  in  the  ModelaDB.xls  worksheet  (see  Figures  4-5,  4-6,  and  4-7)  with 
R  =  0.75,  N  =  4,  and  E  =  1.  The  data  displayed  in  Table  4-3  shows  a  set  of  three  points  for  each  curve. 
The  first  point  is  represented  by  the  rows  with  Unit  Cost  of  Reused  Code  (CVR)  =  0.5.  The  second 
point  of  each  curve  has  CVR  =  1.  The  third  point  of  each  curve  has  CVR  =  1.5.  In  each  case,  you  will 
notice  that  R  =  K.  This  forces  the  value  for  E  to  equal  1.  Thus,  we  get  the  desired  display.  This  graph 
displays  the  effect  on  Relative  Product  Productivity  (P)  of  varying  R  as  CVR  increases,  assuming  that 
maximal  reuse  of  code  is  occurring  and  other  parameters  are  held  constant.  To  generate  the  Relative 
Product  Productivity  vs  Relative  Reuse  Cost  Graph  for  R  =  0.35,  0.75,  and  0.95  with  N  =  4  and  E=  1: 

1.  Scan  your  data  to  be  sure  that  it  does  not  contain  extra  rows  that  match  your  intended  selection 

criteria  but  are  not  meant  to  be  plotted  (e.g.,  you  might  have  a  row  with  N  =  4,  CDE  =  15, 
CVN  =  10,  CVR  =  1,  and  E  =  1,  which  is  not  comparable  to  the  data  shown  above  because  the 

unit  costs  are  not  the  same).  If  such  data  exists,  eliminate  it  from  selection  by  temporarily 

modifying  its  value  for  the  selection  criteria  (e.g.,  you  could  set  N  =  10  to  eliminate  it  from 
selection). 

2.  Select  Relative  Product  Productivity  vs  Relative  Reuse  Cost  from  the  Graphs  menu  to  display 
the  Graph2A  Inputs  Dialog  Box  (as  shown  in  Figure  4-15). 

3.  Select  Number  of  curves  to  plot  =  3. 

4.  Select  Proportion  of  Code  Reuse  for  Curve  1  =  0.35. 

5.  Select  Proportion  of  Code  Reuse  for  Curve  2  =  0.75. 


6.  Select  Proportion  of  Code  Reuse  for  Curve  3  =  0.95. 


4.  Operating  the  Tool 


7.  Click  the  [OK]  button  in  the  Graph2a  Inputs  Dialog  Box  to  display  the  Graph2b  Inputs  Dialog 
Box  (as  shown  in  Figure  4-16). 

8.  Select  Number  of  Application  Systems  =  4. 

9.  Select  Library  Efficiency  for  all  curves  =  1. 

10.  Click  the  [OK]  button  in  the  Graph2B  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 
data  (as  shown  in  Figure  4-17). 

4.4.4J  Product  Productivity  vs  Number  of  Application  Systems  Graph 

The  Product  Productivity  vs  Number  of  Application  Systems  graph  format  provides  up  to  three 
graphs  of  product  productivity,  Py  (Pu  =  1,000/Cus)>  versus  the  number  of  application  systems,  N. 
The  three  graphs  differ  with  respect  to  the  values  of  R,  the  proportion  of  code  reuse,  that  you  select. 

Note:  You  should  ensure  that  all  of  the  points  plotted  use  the  same  values  for  the  unit  costs  of  reuse 
program  investment  (Cde).  new  code  (Cvn)>  and  reusing  code  (Cvr). 

One  dialog  box  appears  for  entering  your  data  (shown  in  Figure  4-18). 


Graph3  Inputs  Dialog  Boh 


Proportion  of  Code  Reuse 

Curue  I  Curve  2  Curve  3 


Figure  4-18.  Mode  la— Graph3  Inputs  Dialog  Box 


The  Graph3  Inputs  Dialog  Box  requests  values  for  the  number  of  curves  to  plot,  the  proportion  of 
code  reuse  for  each  curve,  and  the  library  efficiency  to  use  in  all  plots. 

•  To  specify  a  value  for  the  number  of  curves  to  plot,  select  the  appropriate  option  button. 

•  To  specify  the  values  for  the  proportion  of  code  reuse  for  each  curve,  select  a  value  from  the 
list  box  corresponding  to  each  desired  curve. 


4.  Operating  the  Tbol 


•  To  specify  a  value  for  the  library  efficiency,  select  a  value  from  the  corresponding  list  box. 

•  To  have  the  selected  inputs  accepted  by  the  application,  click  the  [OK]  button  and  the  graph 
build  operation  will  continue. 

•  Clicking  the  [Cancel]  button  will  termmate  the  graph  build  operation  and  return  control  to 
the  Mode  la  window. 

When  you  complete  your  entries,  the  graph  window  displays  the  resultant  graph  (see  Figure  4-19).  Note 
that  the  “cross-over”  in  the  plots  at  a  value  of  N,  the  number  of  application  systems,  is  slightly  less  than  2. 
The  cross-over  occurs  at  a  value  of  N  =  No,  the  break-even  number  of  systems.  For  N  less  than  Nq,  higher 
values  of  R  (the  proportion  of  reuse)  make  the  unit  cost  of  an  application  system  more  expensive. 


Figure  4-19.  Mode  la— Product  Productivity  vs  Number  of  Application  Systems  Graph  Window 


Table  4-4  shows  the  input  data  values  that  produced  the  graph  in  Figure  4-19. 

Example:  The  data  for  each  curve  is  selected  based  on  the  values  you  specify  for  the  Proportion  of  Code 
Reuse  (R)  and  the  Library  Efficiency  (E).  Using  the  dialog  box  shown  in  Figure  4-18.  the  first  curve 
will  display  a  point  for  each  row  in  the  ModvJaDB.xls  worksheet  (see  Figures  4-5,  4-6,  and  4-7)  with 
R  =  0.3  and  E=  1.  Similarly,  the  second  curve  will  display  a  point  for  each  row  in  the  ModelaDB.xls 
worksheet  (see  Figures  4-5, 4-6,  and  4-7)  with  R  =0.5  and  E  =  1.  The  data  displayed  in  Table  4-4  shows 
a  set  of  five  points  for  each  curve.  The  first  point  is  represented  by  the  rows  with  Number  of  Applica¬ 
tion  Systems  (N)  =  1.  The  second  point  of  each  curve  has  N  =  2.  The  third  point  of  each  curve  has  N  =  5. 
In  each  case,  you  will  notice  that  R  =  K.  This  forces  the  value  for  E  to  equal  1.  Thus,  we  get  the  desired 
display.  This  graph  displays  the  effect  on  Product  Productivity  (PU)  of  varying  R  as  N  increases  (as¬ 
suming  that  maximal  reuse  of  code  is  occurring  and  holding  other  parameters  constant)  To  generate 
the  Product  Productivity  vs  Number  of  Application  Systems  Graph  for  R  =  0.3. 0  5.  and  0.7  with  E  =  1 : 
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4.  Operating  the  Tool 


TM>le  4-4.  Input  Data  Values  for  Product  Productivity  vs 
Number  of  Application  Systems  Graph  Window 


Number  of 
Application 
Systems 
(N) 

Proportion  of 
Code  Reuse 
(R) 

Unit  Cost  of 
Reuse  Program 
Investment 
(Cde) 

Unit  Cost  of 
New  Code 
(Cvn) 

Unit  Cost  of 
Reused  Code 
vCvr) 

Relative 

Library 

Capacity 

(K) 

1 

0.3 

7.5 

5 

0.5 

0.3 

1 

0.5 

7.5 

5 

0.5 

0.5 

1 

0.7 

7.5 

5 

0.5 

0.7 

5 

0.3 

7.5 

5 

0.5 

0.3 

5 

0.5 

7.5 

5 

0.5 

0.5 

5 

0.7 

7.5 

5 

0.5 

0.7 

7 

0.3 

7.5 

5 

0.5 

0.3 

7 

0.5 

7.5 

5 

0.5 

0.5 

7 

0.7 

7.5 

5 

0.5 

0.7 

9 

0.3 

7.5 

5 

0.5 

0.3 

9 

0.5 

7.5 

5 

0.5 

0.5 

9 

0.7 

7.5 

5 

0.5 

0.7 

12 

0.3 

7.5 

5 

0.5 

0.3 

12 

0.5 

7.5 

5 

0.5 

0.5 

12 

0.7 

7.5 

5 

0.5 

0.7 

1.  Scan  your  data  to  be  sure  that  it  does  not  contain  extra  rows  that  match  your  intended  selection 
criteria  but  are  not  meant  to  be  plotted  (e.g.,  you  might  have  a  row  with  N  =  1,  R  =  0.3, 
CDE  =  15.  CVN  =  10.  CVR  =  1,  and  K  =  0.3,  which  is  not  comparable  to  the  data  shown  above 
because  the  unit  costs  are  not  the  same).  If  such  data  exists,  eliminate  it  from  selection  by  tem¬ 
porarily  modifying  its  value  for  the  selection  keys  (e.g.,  you  could  set  K  =  0.4  to  eliminate  it 
from  selection). 

2.  Select  Product  Productivity  vs  Number  of  Application  Systems  from  the  Graphs  menu  to 
display  the  Graph3  Inputs  Dialog  Box  (as  shown  in  Figure  4-18). 

3.  Select  Number  of  curves  to  plot  =  3. 

4.  Select  Proportion  of  Code  Reuse  for  Curve  1  =  0.3. 

5.  Select  Proportion  of  Code  Reuse  for  Curve  2  =  0.5. 

6.  Select  Proportion  of  Code  Reuse  ftv  Curve  3  =  0.7. 

7.  Select  Library  Efficiency  for  all  curves  =  1. 

8.  Click  the  [OK]  button  in  the  Graph3  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 
data  (as  shown  in  Figure  4-19). 
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4.  Operating  the  Tool 


4.4.4.4  Return  on  Investment  vs  Number  of  Application  Systems  Graph 

The  Return  on  Investment  vs  Number  of  Application  Systems  graph  format  provides  up  to  three 
graphs  of  return  on  investment  (ROI)  versus  the  number  of  application  systems,  N.  The  three  graphs 
differ  with  respect  to  the  value  of  E,  the  library  efficiency,  that  you  use. 

Note:  You  should  ensure  that  all  of  the  points  plotted  use  the  same  values  for  the  unit  costs  of  reuse 
program  investment  (CdeX  new  code  (Cvn)>  anc*  reusing  code  (Cvr). 

One  dialog  box  appears  for  entering  your  data  (shown  in  Figure  4-20). 


Graph4  Inputs  Dialog  Bok 


Number  of  curues  to  plot 


01 

02 
(s>  3 


OD 

[  Cancel  ) 


Library  Efficiency 

Curue  1  Curue  2  Curue  3 


Figure  4-20.  Mode  la— Graph4  Inputs  Dialog  Box 


The  Graph4  Inputs  Dialog  Box  requests  values  for  the  number  of  curves  to  plot  and  the  library 
efficiency  for  each  curve. 


•  To  specify  a  value  for  the  number  of  curves  to  plot,  select  the  appropriate  option  button. 

•  To  specify  the  values  for  the  library  efficiency  for  each  curve,  select  a  value  from  the  list  box 
corresponding  to  each  desired  curve. 

•  To  have  the  selected  inputs  accepted  by  the  application,  click  the  [OK]  button  and  the  graph 
build  operation  will  continue. 

•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to 
the  Mode  la  window. 


When  you  complete  your  entries,  the  graph  window  displays  the  graph  (see  Figure  4-21).  Note  that 
the  ROI  is  negative  when  N,  the  number  of  application  systems,  is  less  than  Nq.  the  break-even  number 
of  systems. 


Table  4-5  shows  the  input  data  values  that  produced  the  graph  in  Figure  4-21. 
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Return  on  Investment  vs  Number  of  Application  Systems 


Number  of  Application  Systems 


- ■ - Library  Efficiency  -0.30 and  - 

° - Library  Efficiency  *0.50 and 

- ♦ - Library  Efficiency  *0.70  and 

Number  of  Breakeven  Systems 

Number  of  Breakeven  Systems 
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=2  38 

Figure  4-21.  Mode  la— Return  on  Investment  vs  Number  of  Application  Systems  Graph  Window 


Table  4-5.  Input  Data  Values  for  Return  on  Investment 


vs  Number  of  Application  Systems  Graph  Window 


4.  Operating  the  Tbol 


Example:  The  data  for  each  curve  is  selected  based  on  the  values  you  specify  for  the  Library  Efficiency 
(E).  Using  the  dialog  box  shown  in  Figure  4-20,  the  first  curve  will  display  a  point  for  each  row  in  the 
ModelaDB.xls  worksheet  (see  Figures  4-5, 4-6,  and  4-7)  with  E  =  0.3.  Similarly,  the  second  curve  will 
display  a  point  for  each  row  in  the  ModelaDB.xls  worksheet  (see  Figures  4-5, 4-6,  and  4-7)  with  E  =  0.5. 
The  data  displayed  in  Table  4-5  shows  a  set  of  five  points  for  each  curve.  The  first  point  is  represented 
by  the  rows  with  Number  of  Application  Systems  (N)=  1.  The  second  point  of  each  curve  has  N  =  2. 
The  third  point  of  each  curve  has  N  =  5.  In  each  case,  you  will  notice  that  K  =  1.  This  means  that  the 
library  covers  100%  of  the  functionality  of  the  application  system  (ST  =  SS).  This  forces  the  value  for 
E  to  numerically  equal  R  (as  E  =  R/K  and  K  =  1).  Therefore,  we  get  the  five  points  for  each  value  of 
R  and,  hence,  the  desired  display.  This  graph  displays  the  effect  on  ROI  of  varying  E  as  N  increases 
(holding  other  parameters  constant).  To  generate  the  Return  on  Investment  vs  Number  of  Application 
Systems  Graph  for  E  =  0.3,  0.5,  and  0.7: 

1.  Scan  your  data  to  be  sure  that  it  does  not  contain  extra  rows  that  match  your  intended  selection 
criteria  but  are  not  meant  to  be  plotted  (e.g.,  you  might  have  a  row  with  N  =  1,  R  =  0.3, 
CDE  =  15,  CVN  =  10,  CVR  =  1,  and  K  =  1,  which  is  not  comparable  to  the  data  shown  above 
because  the  unit  costs  are  not  the  same).  If  such  data  exists,  eliminate  it  from  selection  by  tem¬ 
porarily  modifying  its  value  for  the  selection  keys  (e.g.,  you  could  set  K  =  0.4,  thereby  forcing 
E  =  0.75  to  eliminate  it  from  selection).  Because  K  is  a  computed  value,  you  must  modify  the 
values  for  ST  and  SS  to  change  the  value  of  K.  Similarly,  E  is  a  computed  value  and,  as  such, 
must  be  modified  by  changing  the  value  of  K  or  R. 

2.  Select  Return  on  Investment  vs  Number  of  Application  Systems  from  the  Graphs  menu  to 
display  the  Graph4  Inputs  Dialog  Box  (as  shown  in  Figure  4-20). 

3.  Select  Number  of  curves  to  plot  =  3. 

4.  Select  Library  Efficiency  for  Curve  1  =  0.3. 

5.  Select  Library  Efficiency  for  Curve  2  =  0.5. 

6.  Select  Library  Efficiency  for  Curve  3  =  0.7. 

7.  Click  the  [OK]  button  in  the  Graph4  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 

data  (as  shown  in  Figure  4-21). 

4.4.4.S  Labor  Months  vs  Number  of  Application  Systems  Graph 

The  Labor  Months  vs  Number  of  Application  Systems  graph  provides  a  bar  chart  which  shows  Reuse 
Program  Investment,  Cost  per  System  With  All  New  Code,  Application  Engineering  Cost  per  System, 
and  Reuse  Program  Investment  Cost  per  System  for  each  of  the  N  applications  in  the  selected  reuse 
scenario. 

One  dialog  box  appears  for  entering  your  data  (shown  in  Figure  4-22). 

The  Graph5  Inputs  Dialog  Box  requests  a  value  for  the  family  number  of  the  reuse  scenario  to  plot. 

•  To  specify  a  value  for  the  family  number: 

-  Select  a  value  from  the  corresponding  list  box. 
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Figure  4-22.  Mode  la— Graphs  Inputs  Dialog  Box 

-  Click  the  [OK]  button  to  transmit  the  selected  value  to  the  application  and  continue 
building  the  graph. 

Note :  Pressing  <  RETURN  >  in  response  to  a  dialog  box  is  the  same  as  clicking  the 
[OK]  button. 

•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to 
the  Mode  la  window. 

When  you  complete  your  entries,  the  graph  window  displays  the  graph  (see  Figure  4-23). 


Figure  4-23.  Mode  la— Labor  Months  vs  Number  of  Application  Systems  Graph  Window 


Table  4-6  shows  the  input  data  values  that  produced  the  graph  in  Figure  4-23. 


4.  Operating  the  Tool 


Table  4-6.  Input  Data  Values  for  Labor  Months  vs  Number  of  Application  Systems  Graph  Window 


Number  of 
Application 
Systems 

(N) 

Proportion 
of  Code 
Reuse 
(R) 

Unit  Cost 
of  Reuse 
Program 
Investment 
(Cde) 

Unit  Cost 
of  New 
Code 
(Cvn) 

Unit  Cost 
of  Reused 
Code 
(Cvr) 

Size  of 
Reuse 
Library 

(ST) 

Average 
Size  of 
Application 
System 
(SS) 

Relative 

Library 

Capacity 

(K) 

7 

0.30 

7.5 

5 

0.5 

30 

100 

0.30 

Example-.  The  data  for  family  22  represents  a  case  where  there  are  seven  application  systems  in  the 
family  and  all  of  the  reuse  program  investment  is  done  up  front.  All  of  the  application  systems  in  the 
family  have  R  =  0.3,  CDE  =  7.5,  C  VN  =  5,  C VR  =  0.5,  ST = 30,  SS  =  100,  and  K  =  0.3  To  generate  the 
Labor  Months  vs  Number  of  Application  Systems  Graph  for  Family  Number  =  1: 

1.  Select  Labor  Months  vs  Number  of  Application  Systems  from  the  Graphs  menu  to  display 
the  Graphl  Inputs  Dialog  Box  (as  shown  in  Figure  4-22). 

2.  Select  Family  Number  =  22. 

3.  Click  the  [OK]  button  in  the  Graph5  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 
family  (as  shown  in  Figure  4-23). 

4.4.5  The  Window  Menu 

The  Window  menu  provides  the  Arrange  All  option,  which  allows  you  to  simultaneously  display  all 
open  windows.  This  is  useful  for  viewing  multiple  graphs  at  the  same  time.  A  sample  display  resulting 
from  invoking  the  Arrange  All  menu  selection  is  shown  in  Figure  4-4. 

4.5  THE  MODE  2  WINDOW 

The  Mode  2  window  appears  when  you  select  Incremental  Reuse  Program  Investment  Without  Cost 
of  Money  from  the  Modes  menu  of  the  Main  window.  It  provides  access  to  all  other  system  functions 
for  Mode  2  operation.  The  window  consists  of  a  custom  menu  bar  and  a  Microsoft  Excel  worksheet 
(see  Figures  4-24,  4-25,  4-26,  4-27,  and  4-28).  The  menu  bar  contains  the  File,  Family,  Application, 
Graphs,  and  Window  menus. 

The  worksheet  contains  the  rows  of  data  that  either  you  entered  or  were  computed  from  the  values 
you  entered.  Each  column  of  data  corresponds  to  a  variable  described  in  the  reuse  economics  model 
detailed  in  Cruickshank  and  Gaffne/  (1991)  and  summarized  in  Appendix  A.  Table  4-7  shows  the 
mapping  of  column  names  to  variable  names. 

Section  4.5.3  describes  the  use  of  the  sample  data  set  presented  in  Figure  4-24. 
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•  File  Family  Application  Graphs  Window 
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System 
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Figure  4-25.  Mode  2  Window  (part  2) 
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*  File  Family  Application  Grophs  Window 
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Figure  4-27.  MihIc  2  Window  (purl  4) 
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Figure  4-28.  Mode  2  Window  (part  5) 


Table  4-7.  Mapping  of  Worksheet  Column  Names  to  Reuse  Economic  Model  Variable  Names 


Worksheet 

Column 

Label 

Worksheet 
Column  Name 

Variable 

Name* 

Constraints 

A 

Family  Number 

FamilyNo 

0  <  FamilyNo 

B 

Application 

Number 

I 

0  <  I 

C 

Number  of 
Application 

Systems 

N 

0  <  N 

D 

Base  Unit  Cost  of 
Reuse  Program 
Investment 

cde 

0  <  Cde 

E 

Base  Unit  Cost  of 
New  Code 

Cvn 

0  <  Cvn 

u. 

Base  Unit  Cost  of 
Reused  Code 

CVr 

0  <  t  VR 

G 

Unit  Cost  of  New 
Code  for  the  i,h 
Application 

System 

CvNi 

0  <  Cvn, 
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Thble  4-7,  continued 


Worksheet 

Column 

Label 

Worksheet 
Column  Name 

Variable 

Name* 

Constraints 

H 

Unit  Cost  of 
Reused  Code  for 
the  i,h  Application 
System 

CvRi 

0  <  CvRj 

I 

Amount  of  Reuse 
Library  Associated 
With  the  i,h 
Application 

System 

STj 

0  <  STj 

J 

Size  of  Reuse 
Library 

ST 

N 

ST  =  ST, 

i=  1 

K 

Amount  of  New 
Code  Developed 
for  the  i,h 
Application 

System 

SNj 

0  <  SN, 

L 

Amount  of 

Reused  Code 
Incorporated  in 
the  i,h  Application 
System 

SR; 

0  <  SR,  <  SumSTi 

M 

Total  Size  of  the 
i,h  Application 
System 

SSi 

SS,  =  SN,  +  SRi 

N 

Proportion  of 

Code  Reuse  for 
the  i,h  Application 
System 

Ri 

R,  =  SR,/SSj 

O 

Relative  Library 
Capacity  for  the  ith 
Application 

System 

Kj 

K,  =  X  STm/SS, 

m  =  1 

P 

Unit  Cost  of  i,h 
Application 

System 

CuSi 

Cus,  =  [(CDE/SS,)»SumTermsl]  +  Cvn^-  1(Cvn,  -  CVr,)*Ri] 

Q 

Cost  of  Product 

Csi 

CS,  =  Cus,  •  SS, 

R 

Application 
Engineering  Cost 
per  System 

^Ai 

CA|  =  (Cvn,  •  SS,)  -  [(Cvn,  -  CvR,)-SR,] 
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Table  4-7,  continued 


Worksheet 

Column 

Label 

Worksheet 
Column  Name 

Variable 

Name* 

Constraints 

S 

Reuse  Program 
Investment  Cost 
per  System 

CoESumTermsI 

CDESumTermsl  =  CDE  •  SumTermsl 

T 

Reuse  Program 
Investment 

CdeSTj 

CdeST,  =  CDE  •  ST, 

U 

Cost  per  System 
With  All  New 
Code 

CT, 

CT»  =  CvNj  •  SS, 

V 

Product 

Productivity 

PU 

PU  =  1,000/Cusj 

W 

Relative  Product 
Productivity 

P 

P  =  Cvn/Cus, 

X 

Relative  Product 
Cost 

C 

C  =  1/P 

Y 

Relative  Reuse 
Cost 

CvRR 

CvRR  =  Cvr/CvN, 

Z 

Sum  Cost  of 
System  With  All 
New  Code 

SumCTj 

N 

SumCT,  =  CT, 

i=i 

AA 

Sum  Reuse 

Program 

Investment 

SuuiCdeST, 

N 

SumCToj-STi  =  ^  ^  CdeSX, 
i=i 

AB 

Sum  Cost  of 
Product 

SumCSj 

N 

SumCS,  =  ]TCS, 

1=1 

AC 

Return  on 
Investment 

ROI 

ROI  =  [(SumCT,-  SumCS,  )/SumCDEST,]*  100 

AD 

Library  Efficiency 

Ej 

E,  =  R,/K, 

AE 

Incremental 
Spending  Penalty 

ISP 

N 

isp  =  Xo-1)*3. 

1=  1 

AF 

Ai 

a; 

a,  =  ST./ST 

AG 

BNi 

BN, 

BN,  =  (1  -  RN)0"” 

AH 

BRi 

BRj 

BR,  =  (1  -  RR),1'1) 

AI 

Rate  of 

Reduction  in  Unit 
Cost  of  New 

Code 

RN 

0  <  RN  <  1 
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Table  4-7,  continued 


Worksheet 

Column 

Label 

Worksheet 
Column  Name 

Variable 

Name* 

Constraints 

AJ 

Rate  of 

Reduction  in  Unit 
Cost  of  Reused 
Code 

RR 

0  <  RR  <  1 

AK 

Current 

Amortized  Size  of 
Library 

SumTermsl 

SumTermsl  =  ^(STm/(N-(rn- 1))) 

m=  1 

AL 

Max  Reuse  Size 

SumSTj 

SumST,  =  STm 

m  =  I 

*  Appendix  A  and  Cruickshank  and  Gaffney  (1991)  use  subscripts  on  some  of  these  variables  such  as  Coe  instead 
of  CDE  and  Cus  instead  of  CUS. 


4.5.1  The  File  Menu 

The  File  menu  provides  the  following  options: 

•  Print  Preview 

-  To  print  the  worksheet,  select  Print  Preview  from  the  File  menu.  The  standard  Microsoft 
Excel  Print  Preview  window  then  appears. 

Note-.  Attempting  to  print  when  there  is  no  printer  connected  may  result  in  a  macro  error. 
Should  this  happen,  click  the  [Halt]  button  to  return  to  normal  operation. 

•  Save 

-  To  save  changes  made  to  the  worksheet,  select  Save  from  the  File  menu.  The  tool  saves 
the  data  and  returns  you  to  the  Mode  2  window.  Saving  a  worksheet  overwrites  the 
previous  data  with  the  current  data.  The  tool  maintains  only  one  version  of  the  worksheet 
and  makes  it  accessible  through  the  application. 

-  To  retain  old  data  indefinitely,  you  should  make  a  copy  of  the  file  Mode2DB.xls  under 
a  new  name.  Do  this  outside  of  the  Reuse  Economics  Spreadsheet  Model  tool. 

-  To  restore  old  data,  rename  a  saved  file  to  Mode2DB.xls.  You  should  be  able  to  print 
a  saved  worksheet  from  Microsoft  Excel.  Saving  old  data  under  different  file  names 
is  a  way  to  preserve  historical  data  associated  with  a  particular  graph  or  set  of  graphs. 

•  Close 

-  To  exit  the  Mode  2  window,  select  Close  from  the  File  menu.  A  dialog  box  appears  to 
warn  you  if  you  have  any  unsaved  changes. 

-  Click  the  [Yes]  or  [No]  button,  as  appropriate,  to  continue  the  Close  process.  When 
the  Close  process  completes,  the  Main  window  appears. 
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4.5.2  Dialog  Box  Description 

The  Family  and  Application  menu  operations  use  a  common  dialog  box  interface.  The  interface  for 
Modify  operations  consists  of  a  sequence  of  two  dialog  boxes.  The  interface  for  Add  and  Delete  opera¬ 
tions  consists  of  a  single  dialog  box  that  is  identical  to  the  second  dialog  box  displayed  for  a  Modify 
operation. 

The  first  dialog  box  contains  check  boxes  for  each  of  the  modifiable  fields.  It  allows  you  to  specify 
which  fields  you  wish  to  modify,  thus  providing  protection  against  inadvertent  data  modification.  You 
must  select  the  check  boxes  for  those  fields  that  you  wish  to  modify.  Clicking  the  [OK]  button  causes 
the  next  dialog  box  in  the  sequence  to  be  displayed.  Clicking  the  [Cancel]  button  terminates  the  current 
operation  and  returns  control  to  the  Mode  2  window. 

The  second  dialog  box  contains  list  boxes,  number  edit  boxes,  and  option  buttons.  It  allows  you  to 
enter  and  display  data  corresponding  to  a  selected  family  or  application.  The  fields  of  the  dialog  box 
are  enabled  or  disabled  in  accordance  with  the  type  of  operation  to  be  performed.  For  example,  when 
performing  a  family  level  operation,  the  Application  Number  list  box  is  disabled.  The  list  boxes  are 
used  for  selecting  family  numbers  and  application  numbers.  The  enabled  number  edit  boxes  are  used 
for  entering  data  for  the  selected  family  or  application.  The  disabled  number  edit  boxes  are  used  to 
display  constraints  or  current  data  values  for  your  convenience.  The  option  buttons  are  used  to  select 
the  desired  form  of  unit  cost  scaling.  For  example,  select  Set  Default  on  the  CVN  Scale  Factors  option 
button  group  to  display  or  enter  the  RN  value.  Clicking  the  [Refresh]  button  updates  the  screen  to 
display  the  dialog  box  with  the  current  values  for  the  selected  family  or  application  shown  in  the  num¬ 
ber  edit  boxes.  Clicking  the  [Accept]  button  carries  out  the  current  operation  and  returns  control  to 
the  dialog  box.  Clicking  the  [Cancel]  button  terminates  the  current  operation  and  returns  control  to 
the  Mode  2  window. 

The  fields  that  are  modifiable  at  the  family  level  include  those  that  are  modifiable  at  the  application 
level  in  addition  to: 

•  CDE.  This  field  corresponds  to  the  Base  Unit  Cost  of  Reuse  Program  Investment.  All  applications 
within  a  family  have  the  same  value  for  CDE.  Due  to  an  implementation  constraint  that  requires 
a  nonzero  value  for  CDE,  it  is  not  possible  to  exactly  model  the  situation  where  there  is  no  Reuse 
Program  Investment  (i.e.,  you  are  reusing  library  components  that  have  been  supplied  to  you  at 
no  cost).  However,  you  can  approximately  model  that  situation  by  supplying  a  small  value 
(e.g.,  0.001)  for  CDE.  This  may  cause  the  Return  on  Investment  field  to  display  a  value  too  large 
for  the  column  width.  Such  a  situation  is  indicated  by  the  presence  of  M#  instead  of  a  numeric 
value  in  the  worksheet  cell. 

•  CVN.  This  field  corresponds  to  the  Base  Unit  Cost  of  New  Code.  All  applications  within  a 
family  have  the  same  value  for  CVN.  Each  application  may  have  a  different  CVNj  (Unit  Cost 
of  New  Code  for  the  ith  Application  System),  which  is  determined  by  adjusting  the  CVN  Scale 
Factor  (BNj  or  RN)  to  obtain  the  desired  CVNj. 

•  C\H.  This  field  corresponds  to  the  Base  Unit  Cost  of  Reused  Code.  All  applications  within 
a  family  have  the  same  value  for  CVR.  Each  application  may  have  a  different  CVR,  (Unit  Cost 
of  Reused  Code  for  the  ilh  Application  System),  which  is  determined  by  adjusting  the  CVR 
Scale  Factor  (BR,  or  RR)  to  obtain  the  desired  CVR,. 
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The  fields  that  are  modifiable  at  the  application  level  are: 

•  S7/.  This  field  corresponds  to  the  Amount  of  Reuse  Library  Associated  with  the  ith  Application 
System. 

•  Sty.  This  field  corresponds  to  the  Amount  of  New  Code  Associated  with  the  ith  Application 
System. 

•  SRi.  This  field  corresponds  to  the  Amount  of  Reused  Code  Associated  with  the  i,h  Application 
System. 

•  CVN  Scale  Factor.  This  field  corresponds  to  either  BNj  or  RN.  When  the  RN  option  button 
is  on,  the  Value  number  edit  box  corresponds  to  RN.  RN  can  be  modified  only  at  the  family 
level.  When  the  BNj  option  button  is  on,  the  number  edit  box  corresponds  to  BNj. 

Note:  The  CVN  Scal^  Factor  is  used  to  compute  CVNj  by  the  formula  CVN,  =  BNj  •  CVN. 
The  default  scaling  formula  used  to  compute  BNj  is  BN;  =  (1  -  RN)  ('  -  J). 

•  CVR  Scale  Factor.  This  field  corresponds  to  either  BR;  or  RR.  When  the  RR  option  button  is 
on,  the  Value  number  edit  box  corresponds  to  RR.  RR  can  be  modified  only  at  the  family  level. 
When  the  BRj  option  button  is  on,  the  Value  number  edit  box  corresponds  to  BRj. 

Note:  The  CVR  Scale  Factor  is  used  to  compute  CVR,  by  the  formula  CVRj  =  BRj  •  CVR. 
The  default  scaling  formula  used  to  compute  BRj  is  BRj  =  (1  -  RR)  ('  -  '). 

4.5.3  The  Family  Menu 

The  Family  menu  consists  of  those  operations  that  can  be  performed  at  the  family  level.  Any  parameter 
values  supplied  to  a  family  level  operation  are  assigned  to  all  application  systems  in  the  family.  This 
allows  you  to  perform  gross  editing  functions,  such  as  assignment  of  unit  cosis  or  allocation  of  reuse 
program  investment,  when  such  assignments  are  constant  across  the  family.  To  perform  detailed 
editing  functions,  you  should  use  the  operations  available  under  the  Application  menu. 

The  Family  menu  provides  the  following  options: 

•  Add  Family 

-  To  add  a  family: 

—  Select  Add  Family  from  the  Family  menu.  The  Add  Family  Dialog  Box  then 
appears  as  shown  in  Figure  4-29. 

—  Enter  values  in  the  fields  provided,  and  ch'ck  the  [Accept]  button.  The  new 
rows  will  be  added  to  the  end  of  the  existing  worksheet  data.  All  of  the  rows 
will  be  identified  by  the  same  Family  Number,  and  each  of  the  N  rows  in  the 
family  (where  N  is  the  Number  of  Application  Systems)  will  have  the  values 
specified  for  the  input  fields. 

-  To  view  an  existing  family,  select  the  desired  Family  Number  from  the  Family  Number 
list  box.  and  click  the  [Refresh]  button.  The  data  for  the  selected  family  will  be  shown 
in  the  corresponding  dialog  box  fields. 
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-  Clicking  the  [Cancel]  button  will  terminate  the  Add  Family  operation  and  return 
control  to  the  Mode  2  window. 

Note:  Pressing  <  RETURN  >  is  the  same  as  clicking  the  [Refresh]  button. 


Figure  4-29.  Mode  2— Add  Family  Dialog  Box 

Example:  To  create  a  family  with  parameter  values  N  =  5.  CDE  =  7.5,  CVN  =  5,  CVR  =  0.5,  STi  =  50, 
SNi  =  50,  SRi  =  50,  RN  =  0.03,  and  RR  =  0.03: 

1.  Select  Add  Family  from  the  Family  menu  to  display  the  Add  Family  Dialog  Box. 

2.  If  there  is  an  existing  family  with  similar  parameter  values,  select  the  existing  family  number 
and  click  the  [Refresh]  button  to  display  the  parameter  values  for  that  family.  Then  modify 
the  parameters  to  the  appropriate  values  for  the  new  family.  If  the  dialog  box  contains  the  data 
as  displayed  in  Figure  4-29,  then  you  need  only  change  the  values  for  STi  and  SRi  from  450 
to  50  because  all  of  the  other  values  are  correct. 


3.  If  there  is  no  existing  family  with  similar  parameter  values,  just  modify  the  displayed  parameter 
values  that  need  to  be  changed  for  the  new  family. 

4.  Click  the  [Accept]  button  to  create  the  new  family. 

5.  Click  the  [Cancel]  button  to  terminate  the  Add  Family  operation. 

Example:  To  create  a  family  with  parameter  values  N  =  5.  CDE  =  7.5,  CVN  =  5.  CVR  =  0.5,  STI  =  150, 
ST2=  120.  ST3  =  90,  ST4  =  60.  STS  =  30,  SNI  =350.  SN2  =  230,  SN3=140.  SN4  =  SO.  SN5  =  50. 
SRI  =  150.  SR2  =  270.  SR3  =  360.  SR4  =  420,  SR5=450.  RN  =  0.03,  and  RR  =  0.03: 
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1.  Select  Add  Family  from  the  Family  menu  to  display  the  Add  Family  Dialog  Box. 

2.  Modify  the  displayed  parameter  values  to  N  =  5,  CDE  =  7.5,  CVN  =  5,  CVR  =  0.5,  STi  =  150, 
SNi  =  350,  SRi  =  150,  RN  =  0.03,  and  RR  =  0.03.  There  is  a  constraint  that  the  value  for  SRi 
cannot  be  greater  than  the  sum  of  the  STi  values  up  to  and  including  the  ith  application  system. 
Therefore,  SRI  must  be  less  than  or  equal  to  STI.  Similarly,  SR2  must  be  less  than  or  equal 
to  STI  +  ST2.  etc. 

3.  Click  the  [Accept]  button  to  create  the  n^w  family. 

4.  Click  the  [Cancel]  button  to  terminate  the  Add  Family  operation. 

5.  Perform  the  Modify  Application  System  operation  to  adjust  the  values  for  STi,  SNi,  and  SRi 
for  each  of  the  application  systems  in  the  newly  created  family. 

•  Modify  Family 

-  To  modify  a  family: 

—  Select  Modify  Family  from  the  Family  menu.  The  Modify  Family  Dialog  Boxl 
then  appears  as  shown  in  Figure  4-30. 

—  Select  the  boxes  corresponding  to  those  values  that  are  to  be  modified. 

—  Click  the  [OK]  button  to  proceed  to  Modify  Family  Dialog  Box2  as  shown  in 
Figure  4-31. 

—  Click  the  [Cancel]  button  to  terminate  the  Modify  Family  operation. 

—  Select  the  corresponding  Family  Number  by  clicking  the  mouse  button  to 
highlight  the  number  in  the  Family  Number  list  box  of  the  Modify'  Family 
Dialog  Box2.  Then  enter  those  values  that  you  wish  to  modify. 

-  Clicking  the  [Accept]  button  will  modify'  the  rows  of  the  selected  family  and  return 
control  to  the  Modify  Family  Dialog  Box2. 

-  Clicking  the  [Refresh]  button  will  update  the  dialog  box  to  display  the  current  values 
for  the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Modify'  Family  operation  and  return 
control  to  the  Mode  2  window. 

Ex.4MPi.il:  To  modify  a  family  to  set  parameters  STi  =  500.  SNi  =  600,  and  SRi  =  450: 

1.  Select  Modify  Family  from  the  Family  menu  to  display  the  Modify  Family  Dialog  Boxl. 

2.  Select  the  check  boxes  for  STi,  SNi.  and  SRi  (as  shown  in  Figure  4-30).  Make  sure  the  check 
boxes  for  nonmodifiable  fields  are  deselected. 

3.  Click  the  [OK]  button  to  proceed  to  the  Modify  Family  Dialog  Box2(as  shown  in  Figure  4-31). 
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Figure  4-30.  Mode  2— Modify  Family  Dialog  Boxl 
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Figure  4-31.  Mode  2— Modify  Family  Dialog  Box2 


4.  Select  the  Family  Number  for  the  family  that  you  wish  to  modify. 

5.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family. 

6.  Set  the  parameter  values  STi  =  500,  SNi  =  600.  and  SRi  =  450  in  the  appropriate  fields. 

7.  Click  the  (Accept]  button  to  modify  the  selected  family. 

8.  Click  the  [Cancel]  button  to  terminate  the  Modify  Family  operation. 
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•  Delete  Family 

-  To  delete  a  family: 

—  Select  Delete  Family  from  the  Family  menu.  The  Delete  Family  Dialog  Box 
then  appears  as  shown  in  Figure  4-32. 

—  Select  the  corresponding  Family  Number  by  clicking  the  mouse  button  to 
highlight  the  number  in  the  Family  Number  list  box. 

-  Clicking  the  [Accept]  button  will  cause  the  Delete  Confirmation  Dialog  Box  to  be 
displayed  (see  Figure  4-12). 

—  Click  the  [OK]  button  if  you  wish  to  proceed  with  the  delete  operation.  The 
rows  of  the  selected  family  will  be  deleted  and  the  remaining  worksheet  data 
will  be  renumbered  to  reflect  the  number  of  different  families  represented  in 
the  worksheet. 

—  Click  the  [Cancel]  button  if  you  wish  to  abort  the  delete  operation. 

-  Clicking  the  [Refresh]  button  will  update  the  dialog  box  with  the  current  values  for 
the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Delete  Family  operation  and  return 
control  to  the  Mode  2  window. 


Figure  4-32.  Mode  2— Delete  Family  Dialog  Box 
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Example-.  To  delete  a  family: 

1.  Select  Delete  Family  from  the  Family  menu  to  display  the  Delete  Family  Dialog  Box  (as  shown 
in  Figure  4-32). 

2.  Select  the  Family  Number  for  the  family  that  you  wish  to  delete. 

3.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family  (just  to  make 
sure  that  you  have  selected  the  correct  family). 

4.  Click  the  [Accept]  button  to  proceed  to  the  Delete  Confirmation  Dialog  Box  (as  shown  in 
Figure  4-12). 

5.  Click  the  [OK]  button  in  the  Delete  Confirmation  Dialog  Box  to  delete  the  selected  family  and 
display  the  Delete  Family  Dialog  Box. 

6.  Click  the  [Cancel]  button  in  the  Delete  Family  Dialog  Box  to  terminate  the  Delete  Family 
operation. 

4.5.4  The  Application  Menu 

The  Application  menu  provides  the  following  options: 

•  Add  Application  System 

-  To  add  N  rows  to  a  family: 

—  Select  Add  Application  System  from  the  Application  menu.  The  Add 
Application  System  Dialog  Box  then  appears  as  shown  in  Figure  4-33. 

—  Enter  N  in  the  Number  of  Application  Systems  field  along  with  the  desired 
values  in  the  fields  provided  and  click  the  [Accept]  button.  The  new  rows  will 
be  added  to  the  selected  family  after  the  selected  application. 

-  Clicking  the  [Refresh]  button  will  update  the  screen  to  display  the  values  for  the 
selected  application  in  the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Add  operation  and  return  control  to 
the  Mode  2  window. 

Example-.  To  add  two  application  systems  to  a  family: 

1.  Select  Add  Application  System  from  the  Application  menu  to  display  the  Add  Application 
System  Dialog  Box. 

2.  Select  the  Family  Number  of  the  family  to  be  modified. 

3.  Select  the  Application  Number  of  the  application  that  you  wish  to  use  as  a  model  for  the  new 
application  systems. 

4.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

5.  Set  the  parameter  value  N  =  2. 
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Figure  4-33.  Mode  2— Add  Application  System  Dialog  Box 

6.  Click  the  [Accept]  button  to  create  two  new  application  systems.  If  the  selected  application 
number  =  i,  the  added  application  systems  will  be  duplicates  of  application  system  i  and  will 
be  assigned  application  numbers  i  +  1  and  i  +  2,  respectively.  The  applications  in  the  family 
will  be  renumbered  to  account  for  the  added  application  systems. 

7.  Click  the  [Cancel]  button  to  terminate  the  Add  Application  System  operation. 

8.  Perform  Modify  Application  System  to  adjust  the  parameter  values  for  each  of  the  newly 
created  application  systems. 

•  Modify  Appi'eation  System 

-  To  modify  an  application  in  a  family: 

—  Select  Modify  Application  System  from  the  Application  menu.  The  Modify 
Application  System  Dialog  Boxl  then  appears  as  shown  in  Figure  4-34. 

—  Select  the  boxes  corresponding  to  those  values  that  are  to  be  modified. 

—  Click  the  [OK]  button  to  proceed  to  Modify  Application  System  Dialog  Box2 
as  shown  in  Figure  4-35. 

—  Click  the  [Cancel]  button  to  terminate  the  Modify  Application  System  operation. 
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—  Select  the  corresponding  family  number  and  application  number  by  clicking 
the  mouse  button  to  highlight  the  numbers  in  the  Family  Number  and  Applica¬ 
tion  Number  list  boxes  respectively.  Then  enter  those  values  that  you  wish  to 
modify. 

-  Clicking  the  [Accept]  button  will  modify  the  selected  application  and  return  control 
to  the  Modify  Application  System  Dialog  Box2. 

-  Clicking  the  [Refresh]  button  will  update  the  screen  to  display  the  current  values  for 
the  selected  application. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Modify  Application  System  operation 
and  return  control  to  the  Mode  2  window. 


Figure  4-34.  Mode  2— Modify  Application  System  Dialog  Boxl 


Figure  4-35.  Mode  2— Modify  Application  System  Dialog  Box2 
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Example:  To  modify  the  application  systems  in  a  family  so  that  the  parameter  values  are  N  =  5, 
CDE  =  7.5,  CVN  =  5,  CVR  =  0.5,  STI  =  150,  ST2=120,  ST3  =  90,  ST4  =  60,  ST5  =  30,  SN1  =  350, 
SN2  =  230,  SN3  =  140,  SN4  =  80,  SN5  =  50,  SRI  =  150,  SR2  =  270,  SR3  =  360,  SR4  =  420,  SR5  =  450, 
RN  =  0.03,  and  RR  =  0.03: 

1.  Select  Modify  Family  from  the  Family  menu  to  display  the  Modify  Family  Dialog  Boxl. 

2.  Select  all  of  the  check  boxes. 

3.  Click  the  [OK]  button  to  proceed  to  the  Modify  Family  Dialog  Box2. 

4.  Select  the  Family  Number  for  the  family  that  you  wish  to  modify. 

5.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family. 

6.  Set  the  parameter  values  CDE  =  7.5,  CVN  =  5,  C VR  =  0.5,  STi  =  150,  SNi  =  350,  SRi  =  150, 
RN  =  0.03,  RR  =  0.03. 

7.  Click  the  [Accept]  button  to  modify  the  selected  family. 

8.  Click  the  [Cancel]  button  to  terminate  Modify  Family  operation. 

9.  Select  Modify  Application  System  from  the  Application  menu  to  display  the  Modify  Application 
System  Dialog  Boxl  (as  shown  in  Figure  4-34). 

10.  Select  the  check  boxes  for  STi,  SNi,  and  SRi  on  the  Modify  Application  System  Dialog  Boxl. 

11.  Click  the  [OK]  button  to  proceed  to  the  Modify  Application  System  Dialog  Box2  (as  shown 
in  Figure  4-35). 

12.  Select  the  Family  Number  of  the  family  to  be  modified. 

13.  Select  Application  Number  =  1. 

14.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

15.  Set  the  parameter  values  STi  =  150,  SNi  =  350,  and  SRi  =  150. 

16.  Click  the  [Accept]  button  to  modify  the  application  system. 

17.  Select  Application  Number  =  2. 

18.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

19.  Set  the  parameter  values  STi  =  120,  SNi  =  230,  and  SRi  =  270. 

20.  Click  the  [Accept]  button  to  modify  the  application  system. 

21.  Select  Application  Number  =  3. 

22.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

23.  Set  the  parameter  values  STi  =  90,  SNi  =  140,  and  SRi  =  360. 

24.  Click  the  [Accept]  button  to  modify  the  application  system. 
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25.  Select  Application  Number  =  4. 

26.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

27.  Set  the  parameter  values  STi  =  60,  SNi  =  80,  and  SRi  =  420. 

28.  Click  the  [Accept]  button  to  modify  the  application  system. 

29.  Select  Application  Number  =  5. 

30.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

31.  Set  the  parameter  values  STi  =  30,  SNi  =  50,  and  SRi  =  450. 

32.  Click  the  [Accept]  button  to  modify  the  application  system. 

33.  Click  the  [Cancel]  button  to  terminate  the  Add  Family  operation. 

•  Delete  Application  System 

-  To  delete  applications  from  a  family: 

—  Select  Delete  from  the  Data  menu.  The  Delete  Application  System  Dialog  Box 
then  appears  as  shown  in  Figure  4-36. 

—  Select  the  corresponding  family  number  and  application  number  from  the 
Family  Number  and  Application  Number  list  boxes,  respectively.  Enter  the 
number  of  applications  to  delete  in  the  number  edit  box  labeled  Number  of 
Application  Systems. 


Figure  4-36.  Mode  2— Delete  Application  Sysicm  Dialog  Box 
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-  Clicking  the  [Accept]  button  will  cause  the  Delete  Confirmation  Dialog  Box  to  be 
displayed  (see  Figure  4-12). 

—  Click  the  [OK]  button  if  you  wish  to  proceed  with  the  delete  operation.  The 
selected  rows  will  be  deleted  from  the  selected  family,  and  the  remaining  work¬ 
sheet  data  will  be  renumbered  to  reflect  the  number  of  applications  in  the  family. 

—  Click  the  [Cancel]  button  if  you  wish  to  abort  the  delete  operation. 

-  Clicking  the  [Refresh]  button  updates  the  screen  to  display  the  current  values  for  the 
selected  application. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Delete  Application  System  operation 
and  return  control  to  the  Mode  2  window. 

Example:  To  delete  Application  Number  =  2  from  Family  Number  =  1: 

1.  Select  Delete  Application  System  from  the  Application  menu  to  display  the  Delete 
Application  System  Dialog  Box  (as  shown  in  Figure  4-36). 

2.  Select  Family  Number  =  1. 

3.  Select  Application  Number  =  2. 

4.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  application  system 
(just  to  make  sure  that  you  have  selected  the  correct  application). 

5.  Click  the  [Accept]  button  to  proceed  to  the  Delete  Confirmation  Dialog  Box  (as  shown  in 
Figure  4-12). 

6.  Click  the  [OK]  button  in  the  Delete  Confirmation  Dialog  Box  to  delete  the  selected  application 
and  to  display  the  Delete  Application  System  Dialog  Box. 

7.  Click  the  [Cancel]  button  in  the  Delete  Application  System  Dialog  Box  to  terminate  the  Delete 
Application  System  operation. 

4.5.5  The  Graphs  Menu 

The  Graphs  menu  generates  the  built-in  graph  for  Mode  2  calculations.  A  dialog  box  appears  when 
you  select  a  graph  from  the  Graphs  menu.  The  input  dialog  box  allows  you  to  specify  the  reuse  scenario 
family  number  to  be  used  in  the  graph.  To  produce  a  graph  from  the  worksheet  data,  select  the  desired 
graph  from  the  Graphs  menu.  There  is  one  built-in  graph  that  you  can  produce  in  Mode  2:  Labor  Months 
vs  Number  of  Application  Systems. 

4.5.5.1  Labor  Months  vs  Number  of  Application  Systems  Graph 

The  Labor  Months  vs  Number  of  Application  Systems  graph  provides  a  bar  chart  measuring  Reuse 
Program  Investment,  Cost  per  System  With  All  New  Code.  Application  Engineering  Cost  per  System, 
and  Reuse  Program  Investment  Cost  per  System  for  each  of  the  N  applications  in  the  selected  reuse 
scenario. 


4-46 


4.  Operating  the  Tbot 


When  entering  your  data,  a  dialog  box  appears  (shown  in  Figure  4-37). 

The  Graphl  Inputs  Dialog  Box  requests  a  value  for  the  family  number  of  the  reuse  scenario  to  plot. 

•  To  specify  a  value  for  the  family  number: 

-  Select  a  value  from  the  corresponding  list  box. 

-  Click  the  [OK]  button  to  transmit  the  selected  value  to  the  application  and  continue 
building  the  graph. 

Note:  Pressing  <  RETURN  >  in  response  to  a  dialog  box  is  the  same  as  clicking  the  [OK] 
button. 

•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to 
the  Mode  2  window. 
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Figure  4-37.  Mode  2— Graphl  Inputs  Dialog  Box 


When  you  complete  your  entries,  the  graph  window  displays  the  resultant  graph  (see  Figure  4-38). 
Table  4-8  shows  the  input  data  values  that  produced  this  graph. 

Example-.  The  data  for  family  1  represents  a  case  where  there  are  five  application  systems  in  the  family 
and  all  of  the  reuse  program  investment  is  done  during  development  of  the  first  application  system 
in  the  family.  All  of  the  subsequent  application  systems  reuse  the  library  components  that  were  devel¬ 
oped  for  that  first  system.  To  generate  the  Labor  Months  vs  Number  of  Application  Systems  Graph 
for  Family  Number  =  1: 


Table  4-8.  Input  Data  Values  for  Labor  Months  vs  Number  of  Application  Systems  Graph  Window 
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Reuse 
Program 
Investment 

(Cde) 

Base  Unit 
Cost  of 
New  Code 
(Cvn) 

— 

Base  Unit 
Cost  of 
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Figure  4-38.  Mode  2— Labor  Months  vs  Number  of  Application  Systems  Graph  Window 


1.  Select  Labor  Months  vs  Number  of  Application  Systems  from  the  Graphs  menu  to  display 
the  Graphl  Inputs  Dialog  Box  (as  shown  in  Figure  4-37). 

2.  Select  Family  Number  =  1. 

3.  Click  the  [OK]  button  in  the  Graphl  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 
family  (as  shown  in  Figure  4-38). 

4.5.6  The  Window  Menu 

The  Window  menu  provides  the  following  options: 

•  Arrange  All.  To  simultaneously  display  all  open  windows,  select  Arrange  All  from  the  Window 
menu.  This  is  useful  for  viewing  multiple  graphs  at  the  same  time. 

•  Calculate  Now.  To  update  the  values  displayed  on  the  worksheet,  select  Calculate  Now  from 
the  Window  menu.  This  is  useful  for  deferring  time  consuming  updates  until  they  are 
requested  by  the  user. 

4.6  THE  MODE  3  WINDOW 

The  Mode  3  window  appears  when  you  select  Incremental  Reuse  Program  Investment  With  Cost  of 
Money  from  the  Modes  menu  of  the  Main  window.  It  provides  access  to  all  other  system  functions 
for  Mode  3  operation.  The  window  consists  of  a  custom  menu  bar  and  a  Microsoft  Excel  worksheet 
(see  Figures  4-39. 4-40, 4-41, 4-42, 4-43,  and  4-44).  The  menu  bar  contains  the  File,  Family,  Application. 
Graphs,  and  Window  menus. 
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Figure  4-39.  Mode  3  Window  (pan  1) 
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Figure  4-43.  Mode  3  Window  (part  5) 


Figure  4-44  Mode  3  Window  (pari  U) 
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The  worksheet  contains  the  rows  of  data  that  either  you  entered  or  were  computed  from  the  values 
you  entered.  Each  column  of  data  corresponds  to  a  variable  described  in  the  reuse  economics  model 
detailed  in  Cruickshank  and  Gaffney  (1991)  and  summarized  in  Appendix  A.  Table  4-9  shows  the 
mapping  of  column  names  to  variable  names. 

Note:  The  sample  data  sets  are  for  demonstration  purposes  only;  you  should  build  your  own. 


Table  4-9.  Mapping  of  Worksheet  Column  Names  to  Reuse  Economic  Model  Variable  Names 


Worksheet 

Column 

Label 

Worksheet 
Column  Name 

Variable 

Name* 

Constraints 

A 

Family  Number 

FamilyNo 

0  <  FamilyNo 

B 

Application 

Number 

I 

0  <  I 

C 

Number  of 
Application 

Systems 

N 

0  <  N 

D 

Base  Unit  Cost  of 
Reuse  Program 
Investment 

Cde 

0  <  Cde 

E 

Base  Unit  Cost  of 
New  Code 

CvN 

C  <  CvN 

F 

Base  Unit  Cost  of 
Reused  Code 

CvR 

0  <  CVR 

G 

Unit  Cost  of  New 
Code  for  the  i,h 
Application  System 

CvNi 

0  <  Cvn( 

H 

Unit  Cost  of 

Reused  C<xlc  for 
the  i,h  Application 
System 

C\R| 

0  <  C\ri 

I 

Interest  Rate 

Rate 

0  <  Rate 

J 

Number  of  Years 

Years 

0  <  Years 

K 

Amount  of  Reuse 
Library  Associated 
With  the  i,h 
Application  System 

ST, 

0  <  ST, 

L 

Si/e  of  Reuse 

Library 

ST 

s>  =  Ysr, 

t=  1 

M 

Amount  of  New 
Cods'  Developed 
for  the  iIh 

Appheation  System 

SN, 

0  <  SN, 
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Table  4-9,  continued 


Worksheet 

Column 

Label 

Worksheet  Column 
Name 

Variable 

Name* 

Constraints 

N 

Amount  of  Reused 
Code  Incorporated 
in  the  i,h 

Application  System 

SRj 

0  <  SR,  <  SumSTj 

O 

Total  Size  of  the  i,h 
Application  System 

SSj 

SS,  =  SN,  +  SR, 

P 

Proportion  of  Code 
Reuse  for  the  i,h 
Application  System 

Ri 

R,  =  SR./SS, 

Q 

Relative  Library 
Capacity  for  the  i,h 
Application  System 

Ki 

K,  =  £  STm/SS, 

m=  l 

R 

Unit  Cost  of  i,h 
Application  System 

CuSi 

CL.S,  =  [(CDE/SS,)*SumTermsl]  +  Cvn, 

-  [(Cvn,  -  Cvr,)*R,] 

S 

Cost  of  Product 

CS 

Cs  =  CuS)  •  SS, 

T 

Application 
Engineering  Cost 
per  System 

CAi 

CA,  =  (Cvn,  •SS^-KCvn.-Cvr.J-SR.J 

U 

Reuse  Program 
Investment  Cost  per 
System 

CoESumTermsl 

CoESumTermsl  =  CDE  •  SumTermsl 

V 

Reuse  Program 
Investment 

CdeSTj 

CdeST,  —  CDE  •  STj 

W 

Cost  per  System 

With  All  New  Code 

CTj 

CT,  =  Cvn,  •  SS, 

X 

Product  Productivity 

PU 

PU  =  1,000/CUS, 

Y 

Relative  Product 
Productivity 

P 

P  =  Cvn,/Cus, 

Z 

Relative  Product 

Cost 

C 

C  =  1/P 

AA 

Relative  Reuse  Cost 

CVRR 

C\'RR  =  Cvr/Cvn, 

AH 

Sum  Cost  of  System 
With  All  New  Code 

SumCTj 

N 

SumCT,  =  ^d’, 

t=l 

AC 

Sum  Reuse  Program 
Investment 

SumCni-STj 

N 

SumCl)EST,  =  ^CDlST, 

l=  1 
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Thble  4-9,  continued 


Worksheet 

Column 

Label 

Worksheet 
Column  Name 

Variable 

Name* 

Constraints 

AD 

Sum  Cost  of 

Product 

SumCSj 

N 

SumCS,  =  ^  CSi 

i  =  1 

AE 

Sum  Cost  of 

Monqr 

SumCOMj 

N 

SumCOM,  =  ^  COM, 

1=  1 

AF 

Return  on 
Investment 

ROI 

ROI  =  [(SumCTj  -  SumCDEST,  -  SumCOMJ/SumCDEST,] 

•  100 

AG 

Library  Efficiency 

Ej 

m 

ii 

50 

75 

AH 

Incremental 
Spending  Penalty 

ISP 

N 

ISP  =  ]T(i-i).a, 

1=1 

AI 

Ai 

a; 

a,  =  ST./ST 

AJ 

Cost  of  Money 

COMj 

j 

COMj  =  a,  •  CDE  •  ST.[1  -  (j  -  i)/(N  -  (i  -  1»] 

i=  1 

.[(1  +  001.Rate)YMrs  -  1] 

AK 

BNi 

BN; 

BN,  -  (l-RNy-') 

AL 

BRi 

BRj 

BR,  =  (1  -  RR)0’1) 

AM 

Rate  of  Reduction 
in  Unit  Cost  of 

New  Code 

RN 

0  <  RN  <  1 

AN 

Rate  of  Reduction 
in  Unit  Cost  of 
Reused  Code 

RR 

0  <  RR  <  1 

AO 

SumTermsl 

SumTermsl 

i 

SumTermsl  =  ^(STro/(N  -  (m  -  1))) 

m  =  1 

AP 

SumSTi 

SumSTj 

i 

SumST,  =  £  STm 

m=  1 

*  Appendix  A  and  Cruickshank  and  Gaffney  (199 1)  use  subscripts  on  some  of  these  variables,  such  as  C de  instead 
of  CDE  and  Cys  instead  of  CUS. 
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4.6.1  The  File  Menu 

The  File  menu  provides  the  following  options: 

•  Print  Preview 

-  To  print  the  worksheet,  select  Print  Preview  from  the  File  menu.  The  standard  Microsoft 
Excel  Print  Preview  window  then  appears. 

Note:  Attempting  to  print  when  there  is  no  printer  connected  may  result  in  a  macro  error. 
Should  this  happen,  click  the  [Halt]  button  to  return  to  normal  operation. 

•  Save 

-  To  save  changes  made  to  the  worksheet,  select  Save  from  the  File  menu.  The  tool  saves 
the  data  and  returns  you  to  the  Mode  3  window.  Saving  a  worksheet  overwrites  the 
previous  data  with  the  current  data.  The  tool  maintains  only  one  version  of  the  worksheet 
and  makes  it  accessible  through  the  application. 

-  To  retain  old  data  indefinitely,  make  a  copy  of  the  file  Mode3DB.xls  under  a  new  name. 
Do  this  outside  of  the  Reuse  Economics  Spreadsheet  Model  tool. 

-  To  restore  old  data,  rename  a  saved  file  to  Mode3DB.xls.  You  should  be  able  to  print 
a  saved  worksheet  from  Microsoft  Excel.  Saving  old  data  under  different  file  names 
is  a  way  to  preserve  historical  data  associated  with  a  particular  graph  or  set  of  graphs. 

•  Close 


-  To  exit  the  Mode  3  window: 

—  Select  Close  from  the  File  menu.  A  dialog  box  appears  to  warn  you  if  you  have 
any  unsaved  changes. 

—  Click  the  [Yes]  or  [No]  button,  as  appropriate,  to  continue  the  Close  process. 
When  the  Close  process  completes,  the  Main  window  appears. 

4.6.2  Dialog  Box  Description 

The  Family  and  Application  menu  operations  use  a  common  dialog  box  interface.  The  interface  for 
Modify  operations  consists  of  a  sequence  of  two  dialog  boxes.  The  interface  for  Add  and  Delete  operations 
consists  of  a  single  dialog  box  that  is  identical  to  the  second  dialog  box  displayed  for  a  Modify  operation. 

The  first  dialog  box  contains  check  boxes  for  each  of  the  modifiable  fields.  It  allows  you  to  specify 
which  fields  you  wish  to  modify,  thus  providing  protection  against  inadvertent  data  modification.  You 
must  select  the  check  boxes  for  those  fields  that  you  wish  to  modify.  Clicking  the  [OK]  button  causes 
the  next  dialog  box  in  the  sequence  to  be  displayed.  Clicking  the  [Cancel]  button  terminates  the  current 
operation  and  returns  control  to  the  Mode  3  window. 

Hie  second  dialog  box  contains  list  boxes,  number  edit  boxes,  and  option  buttons.  It  allows  you  to 
enter  and  display  data  corresponding  to  a  selected  family  or  application.  The  fields  of  the  dialog  box 
are  enabled  or  disabled  in  accordance  with  the  type  of  operation  to  be  performed.  For  example,  when 
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performing  a  family  level  operation,  the  Application  Number  list  box  is  disabled.  The  list  boxes  are 
used  for  selecting  family  and  application  numbers.  The  enabled  number  edit  boxes  are  used  for  enter¬ 
ing  data  for  the  selected  family  or  application.  The  disabled  number  edit  boxes  are  used  to  display 
constraints  or  current  data  values  for  your  convenience.  The  option  buttons  are  used  to  select  the  de¬ 
sired  form  of  unit  cost  scaling.  For  example,  select  Set  Default  on  the  CVN  Scale  Factors  option  button 
group  to  display  or  enter  the  RN  value.  Clicking  the  [Refresh]  button  updates  the  screen  to  display  the 
dialog  box  with  the  current  values  for  the  selected  family  or  application  shown  in  the  number  edit  boxes. 
Clicking  the  [Accept]  button  carries  out  the  current  operation  and  returns  control  to  the  dialog  box. 
Clicking  the  [Cancel]  button  terminates  the  current  operation  and  returns  control  to  the  Mode  3  window. 

The  fields  that  are  modifiable  at  the  family  level  include  those  that  are  modifiable  at  the  application 
level  in  addition  to: 

•  CDE.  This  field  corresponds  to  the  Base  Unit  Cost  of  Reuse  Program  Investment.  All  applications 
within  a  family  have  the  same  value  for  CDE.  Due  to  an  implementation  constraint  that  requires 
a  nonzero  value  for  CDE,  it  is  not  possible  to  exactly  model  the  situation  where  there  is  no  Reuse 
Program  Investment  (i.e.,  you  are  reusing  library  components  that  have  been  supplied  to  you  at 
no  cost).  However,  you  can  approximately  model  that  situation  by  supplying  a  small  value 
(e.g.,  0.001)  for  CDE.  This  may  cause  the  Return  on  Investment  field  to  display  a  value  too  large 
for  the  column  width.  Such  a  situation  is  indicated  by  the  presence  of  ###  instead  of  a  numeric 
value  in  the  worksheet  cell. 

•  CVN.  This  field  corresponds  to  the  Base  Unit  Cost  of  New  Code.  All  applications  within  a 
family  have  the  same  value  for  CVN.  Each  application  may  have  a  different  CVN,  (Unit  Cost 
of  New  Code  for  the  ith  Application  System),  which  is  determined  by  adjusting  the  CVN  Scale 
Factor  (BNj  or  RN)  to  obtain  the  desired  CVN;. 

•  CVR.  This  field  corresponds  to  the  Base  Unit  Cost  of  Reused  Code.  All  applications  within 
a  family  have  the  same  value  for  CVR.  Each  application  may  have  a  different  CVR;  (Unit  Cost 
of  Reused  Code  for  the  ilh  Application  System),  which  is  determined  by  adjusting  the  CVR 
Scale  Factor  (BRj  or  RR)  to  obtain  the  desired  CVR;. 

The  fields  that  are  modifiable  at  the  application  level  are: 

•  ST;.  This  field  corresponds  to  the  Amount  of  Reuse  Library  Associated  with  the  ith  Application 
System. 

•  SNi.  This  field  corresponds  to  the  Amount  of  New  Code  Associated  with  the  ith  Application 
System. 

•  SR;.  This  field  corresponds  to  the  Amount  of  Reused  Code  Associated  with  the  ith  Application 
System. 

•  CVN  Scale  Factor.  This  field  corresponds  to  either  BN;  or  RN.  When  the  RN  option  button  is  on. 
the  Value  number  edit  box  corresponds  to  RN.  Modification  of  RN  is  only  applicable  at  the  family 
level.  When  the  BN,  option  button  is  on,  the  Value  number  edit  box  corresponds  to  BN,. 

Non:  The  CVN  Scale  Factor  is  used  to  compute  CVN,  by  the  formula  CVN,  =  BN,  •  CVN. 

'Hie  default  scaling  formula  used  to  compute  BN,  is  BN,  =  (1  -  RN)  u  -  n 
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•  CVR  Scale  Factor.  This  field  corresponds  to  either  BRj  or  RR.  When  the  RR  option  button  is  on, 
the  Value  number  edit  box  corresponds  to  RR.  Modification  of  RR  is  only  applicable  at  the  family 
level.  When  the  BRj  option  button  is  on,  the  Value  number  edit  box  corresponds  to  BRj. 

Note:  The  CVR  Scale  Factor  is  used  to  compute  CVRj  by  the  formula  CVRj  =  BRj  •  CVR. 
The  default  scaling  formula  used  to  compute  BRj  is  BRj  =  (1  -  RR) (i  -  1>. 

4.63  The  Family  Menu 

The  Family  menu  consists  of  those  operations  that  can  be  performed  at  the  family  level.  Any  parameter 
values  supplied  to  a  family  level  operation  are  assigned  to  all  application  systems  in  the  family.  This 
allows  you  to  perform  gross  editing  functions,  such  as  assignment  of  unit  costs  or  allocation  of  reuse 
program  investment,  when  such  assignments  are  constant  across  the  family.  To  perform  detailed 
editing  functions,  you  should  use  the  operations  available  under  the  Application  menu. 

The  Family  menu  provides  the  following  options: 

•  Add  Family 

-  To  add  a  family: 

—  Select  Add  Family  from  the  Family  menu.  The  Add  Family  Dialog  Box  then 
appears  as  shown  in  Figure  4-45. 

—  Enter  values  in  the  fields  provided,  and  click  the  [Accept]  button.  The  new 
rows  will  be  added  to  the  end  of  the  existing  worksheet  data.  All  of  the  rows 
will  be  identified  by  the  same  Family  Number,  and  each  of  the  N  rows  in  the 
family  (where  N  is  the  Number  of  Application  Systems)  will  have  the  values 
specified  for  the  input  fields. 

-  To  view  an  existing  family,  select  the  desired  Family  Number  from  the  Family  Number 
list  box,  and  click  the  [Refresh]  button.  The  data  for  the  selected  family  will  be  shown 
in  the  corresponding  dialog  box  fields. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Add  Family  operation  and  return 
control  to  the  Mode  3  window. 

Note:  Pressing  <  RETURN  >  is  the  same  as  clicking  the  [Refresh]  button. 

Example:  To  create  a  family  with  parameter  values  N  =  5,  CDE  =  7.5,  CVN  =  5,  CVR  =  0.5.  Interest 
Rate  =  8.  Years  =  4,  STi  =  450,  SNi  =  50,  SRi  =  450.  RN  =  0.03,  and  RR  =  0.03: 

1.  Select  Add  Family  from  the  Family  menu  to  display  the  Add  Family  Dialog  Box  (as  shown 
in  Figure  4-45). 

2.  If  there  is  an  existing  family  with  similar  parameter  values,  select  the  existing  family  number 
and  click  the  [Refresh]  button  to  display  the  parameter  values  for  that  family.  Then  modify 
the  parameters  to  the  appropriate  values  for  the  new  family.  If  the  dialog  box  contains  the  data 
as  displayed  in  Figure  4-45,  then  no  changes  are  necessary  because  all  of  the  displayed  values 
are  correct. 
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Figure  4-45.  Mode  3— Add  Family  Dialog  Box 

3.  If  there  is  no  existing  family  with  similar  parameter  values,  just  modify  the  displayed  parameter 
values  that  need  to  be  changed  for  the  new  family. 

4.  Click  the  [Accept]  button  to  create  the  new  family. 

5.  Click  the  [Cancel]  button  to  terminate  the  Add  Family  operation. 


Example:  To  create  a  family  with  parameter  values  N  =  5,  CDE  =  7.5,  CVN  =  5,  CVR  =  0.5,  Interest 
Rate  =  8,  Years  =  4,  ST1  =  225,  ST2  =  225,  ST3  =  0,  ST4  =  0,  ST5  =  0,  SN1  =  275,  SN2  =  50,  SN3  =  50. 
SN4  =  50,  SN5  =  50,  SRI  =  225,  SR2  =  450,  SR3  =  450,  SR4  =  450.  SR5  =  450,  RN  =  0.03.  and  RR  =  0.03: 

1.  Select  Add  Family  from  the  Family  menu  to  display  the  Add  Family  Dialog  Box. 

2.  Modify  the  displayed  parameter  values  to  N  =  5,  CDE  =  7.5,  CVN  =  5.  CVR  =  0.5,  Interest 
Rate  =  8,  Years  =  4,  STi  =  225,  SNi  =  50,  SRi  =225.  RN  =  0.03.  and  RR  =  0.03.  There  is  a 
constraint  that  the  value  for  SRi  cannot  be  greater  than  the  sum  of  the  STi  values  up  to  and 
including  the  ith  application  system.  Therefore,  SRI  must  be  less  than  or  equal  to  STI.  Similarly. 
SR2  must  be  less  than  or  equal  to  STI  +  ST2.  etc. 

3.  Click  the  [Accept]  button  to  create  the  new  family. 
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4.  Click  the  [Cancel]  button  to  terminate  the  Add  Family  operation. 

5.  Perform  the  Modify  Application  System  operation  to  adjust  the  values  for  STi,  SNi,  and  SRi 
for  each  of  the  application  systems  in  the  newly  created  family. 

•  Modify  Family 

-  To  modify  a  family: 

—  Select  Modify  Family  from  the  Family  menu.  The  Modify  Family  Dialog  Boxl 
then  appears  as  shown  in  Figure  4-46. 

—  Select  the  boxes  corresponding  to  those  values  to  be  modified. 

—  Click  the  [OK]  button  to  proceed  to  Modify  Family  Dialog  Box2  as  shown  in 
Figure  4-47. 

—  Click  the  [Cancel]  button  to  terminate  the  Modify  Family  operation. 

—  To  modify  a  group  of  rows  representing  a  family,  select  the  corresponding  Family 
Number  by  clicking  the  mouse  button  to  highlight  the  number  in  the  Family 
Number  list  box  of  the  Modify  Family  Dialog  Box2.  Enter  those  values  that 
you  wish  to  modify.  Then  click  the  [Accept]  button.  The  rows  of  the  selected 
family  will  be  modified,  and  control  will  return  to  the  Modify  Family  Dialog 
Box2. 

-  Clicking  the  [Refresh]  button  will  update  the  dialog  box  to  display  the  current  values 
for  the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Modify  Family  operation  and  return 
control  to  the  Mode  3  window. 


Figure  4-46.  Mode  3— Modify  Family  Dialog  Boxl 


Example-.  To  modify  a  family  to  set  parameters  CDE  =  6,  CVN  =  8.5,  and  CVR  =  1.5: 

1.  Select  Modify  Family  from  the  Family  menu  to  display  the  Modify  Family  Dialog  Boxl. 


2.  Select  the  check  boxes  for  CDE,  CVN,  and  CVR  (as  shown  in  Figure  4-46).  Make  sure  the 
check  boxes  for  nonmodifiable  fields  are  deselected. 
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Figure  4-47.  Mode  3— Modify  Family  Dialog  Box2 

3.  Click  the  [OK]  button  to  proceed  to  the  Modify  Family  Dialog  Box2  (as  shown  in  Figure  4-47). 

4.  Select  the  Family  Number  for  the  family  that  you  wish  to  modify. 

5.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family. 

6.  Set  the  parameter  values  CDE  =  6,  CVN  =  8.5,  and  CVR  =  1.5  in  the  appropriate  fields. 

7.  Click  the  [Accept]  button  to  modify  the  selected  family. 

8.  Click  the  [Cancel]  button  to  terminate  the  Modify  Family  operation. 

•  Delete  Family 

-  To  delete  a  family: 

—  Select  Delete  Family  from  the  Family  menu.  The  Delete  Family  Dialog  Box 
then  appears  as  shown  in  Figure  4-48. 

—  Select  the  corresponding  Family  Number  by  clicking  the  mouse  button  to 
highlight  the  number  in  the  Family  Number  list  box. 

-  Clicking  the  [Accept]  button  will  ca'’se  the  Delete  Confirmation  Dialog  Box  to  be 
displayed  (see  Figure  4-12). 
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—  Click  the  [OK]  button  if  you  wish  to  proceed  with  the  delete  operation.  The 
row  of  the  selected  family  will  be  deleted  and  the  remaining  worksheet  data 
will  be  renumbered  to  reflect  the  number  of  different  families  represented  in 
the  worksheet. 

—  Click  the  [Cancel]  button  if  you  wish  to  abort  the  delete  operation. 

-  Clicking  the  [Refresh]  button  will  update  the  dialog  box  with  the  current  values  for 
the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Delete  Family  operation  and  return 
control  to  the  Mode  3  window. 


Figure  4-48.  Mode  3— Delete  Family  Dialog  Box 


Example-.  To  delete  Family  Number  =  1: 


1.  Select  Delete  Family  from  the  Family  menu  to  display  the  Delete  Family  Dialog  Box  (as  shown 
in  Figure  4-48). 

2.  Select  Family  Number  =  1. 

3.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  family  (just  to  make 
sure  that  you  have  selected  the  correct  family). 

4.  Click  the  [Accept]  button  to  proceed  to  the  Delete  Confirmation  Dialog  Box  (as  shown  in 
Figure  4-12). 
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5.  Click  the  [OK]  button  in  the  Delete  Confirmation  Dialog  Box  to  delete  the  selected  family  and 
to  display  the  Delete  Family  Dialog  Box. 

6.  Click  the  [Cancel]  button  in  the  Delete  Family  Dialog  Box  to  terminate  the  Delete  Family 
operation. 

4.6.4  The  Application  Menu 

The  Application  menu  provides  the  following  options: 

•  Add  Application  System 

-  To  add  N  rows  to  a  family: 

—  Select  Add  Application  System  from  the  Application  menu.  The  Add 
Application  System  Dialog  Box  then  appears  as  shown  in  Figure  4-49. 

—  Enter  N  in  the  Number  of  Application  Systems  field  along  with  the  desired 
values  in  the  fields  provided,  and  click  the  [Accept]  button.  The  new  rows  will 
be  added  to  the  selected  family  after  the  selected  application. 

-  Clicking  the  [Refresh]  button  will  update  the  screen  to  display  the  values  for  the 
selected  application  in  the  selected  family. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Add  operation  and  return  control  to 
the  Mode  3  window. 

Example:  To  add  three  application  system  to  a  family: 

1.  Select  Add  Application  System  from  the  Application  menu  to  display  the  Add  Application 
System  Dialog  Box  (as  shown  in  Figure  4-49). 

2.  Select  the  Family  Number  of  the  family  to  be  modified. 

3.  Select  the  Application  Number  of  the  application  that  you  wish  to  use  as  a  model  for  the  new 
application  systems. 

4.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

5.  Set  the  parameter  value  N  =  3. 

6.  Click  the  [Accept]  button  to  create  three  new  application  systems.  If  the  selected  application 
number  =  i,  the  added  application  systems  will  be  duplicates  of  application  system  i  and  will 
be  assigned  application  numbers  i  +  1,  i  +  2,  and  i  +  3,  respectively.  The  applications  in  the 
family  will  be  renumbered  to  account  for  the  added  application  systems. 

7.  Click  the  [Cancel]  button  to  terminate  the  Add  Application  System  operation. 
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Figure  4-49.  Mode  3— Add  Application  System  Dialog  Box 
Modify  Application  System 

-  To  modify  an  application  within  a  family: 

—  Select  Modify  Application  System  from  the  Application  menu.  The  Modify 
Application  System  Dialog  Boxl  then  appears  as  shown  in  Figure  4-50. 

—  Select  the  boxes  corresponding  to  those  values  that  are  to  be  modified. 

—  Click  the  [OK]  button  to  proceed  to  Modify  Application  System  Dialog  Box2 
as  shown  in  Figure  4-51. 

—  Click  the  [Cancel]  button  to  terminate  the  Modify  Application  System  operation. 

—  Select  the  corresponding  family  number  and  application  number  by  clicking 
the  mouse  button  to  highlight  the  numbers  in  the  Family  Number  and  Applica¬ 
tion  Number  list  boxes,  respectively.  Fnter  those  values  that  you  wish  to 
modify.  Then  click  the  [Accept]  button.  The  rows  of  the  selected  application 
will  be  modified,  and  control  will  return  to  the  Modify  Application  System 
Dialog  Box2. 

-  (.’licking  the  [Refresh]  button  will  update  the  screen  to  display  the  current  values  for 
the  selected  application. 
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-  Clicking  the  [Cancel]  button  will  terminate  the  Modify  Application  System  operation 
and  return  control  to  the  Mode  3  window. 
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Figure  4-50.  Mode  3— Modify  Application  System  Dialog  Boxl 


Figure  4-51.  Mode  3— Modify  Application  System  Dialog  Bo.\2 

Example:  To  modify  the  application  systems  in  a  family  such  that  the  parameter  values  are  N  =  5, 
CDE  =  7.5,  CVN  =  5,  CVR  =  0.5,  Interest  Rate  =  8.  Years  =  4,  STI  =  225,  ST2  =  225.  ST3  =  0.  ST4  =  0. 
STS  =  0,  SNI  =  275,  SN2  =  50.  SN3  =  50.  SN4  =  50.  SN5  =  50.  SRI  =  225.  SR2  =  450.  SR3  =  450. 
SR4  =  450.  SR5  =  450,  RN  =  0.03.  and  RR  =  0.03: 
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1.  Select  Modify  Application  System  from  the  Application  menu  to  display  the  Modify 
Application  System  Dialog  Boxl  (as  shown  in  Figure  4-50). 

2.  Select  the  check  boxes  for  STi,  SNi,  and  SRi  on  the  Modify  Application  System  Dialog  Boxl. 

3.  Click  the  [OK]  button  to  proceed  to  the  Modify  Application  System  Dialog  Box2  (as  shown 
in  Figure  4-51). 

4.  Select  the  Family  Number  of  the  family  to  be  modified. 

5.  Select  Application  Number  =  1. 

6.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

7.  Set  the  parameter  values  STi  =  225,  SNi  =  275,  and  SRi  =  225. 

8.  Click  the  [Accept]  button  to  modify  the  application  sys'em. 

9.  Select  Application  Number  =  2. 

10.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

11.  Set  the  parameter  values  STi  =  225,  SNi  =  50,  and  SRi  =  450. 

12.  Click  the  [Accept]  button  to  modify  the  application  system. 

13.  Select  Application  Number  =  3. 

14.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

15.  Set  the  parameter  values  STi  -  -  0,  SNi  =  50,  and  SRi  =  450. 

16  Click  the  [Accept]  button  to  modify  the  application  system. 

17.  Select  Application  Number  =  4. 

18.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

19.  Set  the  parameter  values  STi  =  0,  SNi  =  50,  and  SRi  =  450. 

20.  Click  the  [Accept]  button  to  modify  the  application  system. 

21.  Select  Application  Number  =  5. 

22.  Click  the  [Refresh]  button  to  display  the  parameters  for  the  selected  application  system. 

23.  Set  the  parameter  values  STi  =  0,  SNi  =  50,  and  SRi  =  450. 

24.  Click  the  [Accept]  button  to  modify  the  application  system. 

25.  Click  the  [Cancel]  button  to  terminate  the  Add  Family  operation. 

•  D' lete  Application  System 

-  To  delete  applications  from  a  family: 

—  Select  Delete  from  the  Data  menu.  The  Delete  Dialog  Box  then  appears  as 
shown  in  Figure  4  52. 
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—  Select  the  corresponding  family  number  and  application  number  from  the 
Family  Number  and  Application  Number  list  boxes,  respectively.  Enter  the 
number  of  applications  to  delete. 

-  Clicking  the  [Accept]  button  will  cause  the  Delete  Confirmation  Dialog  Box  to  be 
displayed  (see  Figure  4-12). 

—  Click  the  [OK]  button  if  you  wish  to  proceed  with  the  delete  operation.  The 
selected  rows  will  be  deleted  from  the  selected  family,  and  the  remaining  work¬ 
sheet  data  will  be  renumbered  to  reflect  the  number  of  applications  in  the  family. 

—  Click  the  [Cancel]  button  if  you  wish  to  abort  the  delete  operation. 

-  Clicking  the  [Refresh]  button  updates  the  screen  to  display  the  current  values  for  the 
selected  application. 

-  Clicking  the  [Cancel]  button  will  terminate  the  Delete  Application  System  operation 
and  return  control  to  the  Mode  3  window. 


Figure  4-52  Mode  3— Delete  Application  System  Dialog  Box 


4-66 


4.  Operating  the  Tool 


Example-.  To  delete  Application  Number =3  from  Family  Number  =  2: 

1.  Select  Delete  Application  System  from  the  Application  menu  to  display  the  Delete 
Application  System  Dialog  Box  (as  shown  in  Figure  4-52). 

2.  Select  Family  Number  =  2. 

3.  Select  Application  Number = 3. 

4.  Click  the  [Refresh]  button  to  display  the  parameter  values  for  the  selected  application  system 
(just  to  make  sure  that  you  have  selected  the  correct  application). 

5.  Click  the  [Accept]  button  to  proceed  to  the  Delete  Confirmation  Dialog  Box  (as  shown  in 
Figure  4-12). 

6.  Click  the  [OK]  button  in  the  Delete  Confirmation  Dialog  Box  to  delete  the  selected  application 
and  to  display  the  Delete  Application  System  Dialog  Box. 

7.  Click  the  [Cancel]  button  in  the  Delete  Application  System  Dialog  Box  to  terminate  the  Delete 
Application  System  operation. 


4.6.5  The  Graphs  Menu 

The  Graphs  menu  generates  the  built-in  graph  for  Mode  3  calculations.  A  dialog  box  appears  when 
you  select  a  graph  from  the  Graphs  menu.  The  input  dialog  box  allows  you  to  specify  the  reuse  scenario 
family  number  to  be  used  in  the  graph.  To  produce  a  graph  from  the  worksheet  data,  select  the  desired 
graph  from  the  Graphs  menu.  There  is  one  built-in  graph  that  you  can  produce  in  Mode  3:  Labor  Months 
vs  Number  of  Application  Systems. 

4.6.5.1  Labor  Months  vs  Number  of  Application  Systems  Graph 

The  Labor  Months  vs  Number  of  Application  Systems  graph  provides  a  bar  chart  measuring  Reuse 
Program  Investment,  Cost  per  System  With  All  New  Code,  Application  Engineering  Cost  per  System, 
and  Reuse  Program  Investment  Cost  per  System  for  each  of  the  N  applications  in  the  selected  reuse 
scenario. 

When  entering  your  data,  a  dialog  box  appears  (see  Figure  4-53). 

The  Graphl  Inputs  Dialog  Box  requests  a  value  for  the  family  number  of  the  reuse  scenario  to  plot. 
•  To  specify  a  value  for  the  family  number: 

-  Select  a  value  from  the  corresponding  list  box. 

-  Click  the  [OK]  button  to  transmit  the  selected  value  to  the  application  and  continue 
building  the  graph. 

Note\  Pressing  <  RETURN  >  in  response  to  a  dialog  box  is  the  same  as  clicking  the 
[OK]  button. 
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•  Clicking  the  [Cancel]  button  will  terminate  the  graph  build  operation  and  return  control  to  the 
Mode  3  window. 


Figure  4-53.  Mode  3— Graph  1  Inputs  Dialog  Box 


When  you  complete  your  entries,  the  graph  window  displays  the  resultant  graph  (see  Figure  4-54). 


Figure  4-54.  Mode  3— Graph]  Window 

Table  4-10  shows  the  input  data  values  that  produced  this  graph. 


Example-.  The  data  for  family  1  represents  a  case  where  there  are  five  application  systems  in  the  family 
and  all  of  the  reuse  program  investment  is  done  during  development  of  the  first  application  system 
in  the  family.  All  of  the  subsequent  application  systems  reuse  the  library  components  that  were  devel¬ 
oped  for  that  first  system.  To  generate  the  Labor  Months  vs  Number  of  Application  Systems  Graph 
for  Family  Number  =  1: 


1.  Select  Labor  Months  vs  Number  of  Application  Systems  from  the  Graphs  menu  to  display 
the  Graph  1  Input®  Dialog  Box  (as  shown  in  Figure  4-53). 
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Table  4-10.  Input  Data  Values  for  Labor  Months  vs  Number  of  Application  Systems  Graph  Window 


Application 

Number 

(i) 

Number  of 
Application 
Systems 
(N) 

Base  Unit 
Cost  of 
Reuse 
Program 
Investment 
(Cde) 

Base  Unit 
Cost  of 
New  Code 
(Cvx) 

Base  Unit 
Cost  of 
Reused 
Code  (Cvr) 

Amount  of 
Reuse 
Library 
Associated 
With  ith 
Application 
System 
(STs) 

Amount  of 
New  Code 
Developed 
for  the  ith 
Application 
System 
(SNP 

Amount  of 
Reused  Code 
Incorporated 
in  the  i**1 
Application 
System  (SR;) 

1 

5 

7.5 

5 

0.5 

450 

50 

450 

2 

5 

7.5 

5 

0.5 

0 

50 

450 

3 

5 

7.5 

5 

0.5 

0 

50 

450 

4 

5 

7.5 

5 

0.5 

0 

50 

450 

5 

5 

7.5 

5 

0.5 

0 

50 

450 

2.  Select  Family  Number  =  1. 

3.  Click  the  [OK]  button  in  the  Graphl  Inputs  Dialog  Box  to  display  the  graph  for  the  selected 
family  (as  shown  in  Figure  4-54). 

4.6.6  The  Window  Menu 

The  Window  menu  provides  the  following  options: 

•  Arrange  All.  To  simultaneously  display  all  open  windows,  select  Arrange  All  from  the  Window 
menu.  This  is  useful  for  viewing  multiple  graphs  at  the  same  time. 

•  Calculate  Now.  To  update  the  values  displayed  on  the  worksheet,  select  Calculate  Now  from 
the  Window  menu.  This  is  useful  for  deferring  time  consuming  updates  until  they  are 
requested  by  the  user. 

4.7  THE  GRAPH  WINDOW 


The  window  for  graphs  appears  when  you  select  a  graph  from  the  Graphs  menu.  It  provides  access  to 
all  other  system  functions  allowed  for  graphs. 

The  Graph  window  consists  of  a  custom  Microsoft  Excel  menu  and  a  Microsoft  Excel  chart  containing 
the  specified  graph  (see  Figure  4-54).  The  menu  bar  contains  the  File  and  Window  menus.  The  File  menu 
allows  you  to  print  the  chart,  save  the  chart,  and  return  to  the  window  from  which  you  invoked  the  Graph 
menu  option.  The  Window  menu  allows  you  to  arrange  multiple  windows  so  that  all  are  displayed  simulta¬ 
neously.  The  chart  plots  the  selected  worksheet  data  in  accordance  with  the  parameters  you  specify  in 
the  graph  input  dialog  boxes. 

The  default  naming  convention  followed  for  graphs  is  Chart?,  where  the  question  mark  is  replaced 
by  a  digit  (starting  at  1)  that  is  incremented  for  each  graph  created  during  a  single  session.  Selecting 
the  Save  option  from  the  File  menu  causes  the  Graph  Save  Dialog  Box  to  appear  (see  Figure  4-55). 
You  may  save  graphs  to  the  default  file  name  or  to  a  user  specified  name. 
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Note :  Saving  a  graph  in  a  directory  other  than  the  current  working  directory  will  result  in  a  macro 
error. 

You  may  also  print  a  saved  graph  using  the  Print  or  Print  Preview  options  of  the  standard  Microsoft 
Excel  File  menu.  When  opening  a  saved  graph  under  standard  Excel,  you  will  be  presented  with  a 
dialog  box  requesting  you  to  “update  references  to  unopened  documents.”  You  must  click  the  [No] 
button  to  display  the  graph  as  it  was  saved.  Clicking  the  [Yes]  button  results  in  the  graph  being  recom¬ 
puted  using  default  data  that  does  not  correspond  to  the  saved  graph.  You  should  rename  saved 
graphs  to  avoid  naming  conflicts  that  can  occur  when  saving  subsequent  graphs.  Should  you  encounter 
a  naming  conflict,  a  dialog  box  appears  requesting  confirmation  to  overwrite  the  existing  graph.  Click 
the  [OK]  button  to  overwrite  the  existing  graph. 

Note:  Clicking  the  [Cancel]  button  causes  a  macro  error  dialog  box  to  appear.  To  recover  from  this 
error,  click  the  [Halt]  button  to  restore  normal  operation. 


Figure  4-55.  Graph  Save  Dialog  Box 
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APPENDIX  A.  REUSE  ECONOMICS 
MATHEMATICAL  MODELS 


A.1  OVERVIEW 

This  appendix  provides  a  detailed  description  of  the  models  implemented  in  the  Reuse  Economics 
Spreadsheet  Model  tool. 

A.2  MODE  la  -  REUSE  WITH  UP-FRONT  REUSE  PROGRAM  INVESTMENT  (DOMAIN 
ENGINEERING) 

A.2.1  Mode  1a  Overview 

Mode  la  implements  the  basic  reuse  economics  model  that  represents  the  cost  of  developing  one  of 
a  family  of  application  systems.  The  cost  of  domain  engineering  is  assumed  to  be  incurred  all  at  once, 
up  front,  with  respect  to  the  development  of  a  family  of  N  systems  and  is  spread  uniformly  (prorated) 
over  them. 

A.2.2  Basic  Unit  Cost  Equation 

An  application  system  consists  of  two  categories  of  code:  new  and  reused.  Development  labor  costs 
are  assignable  to  these  two  categories  of  code  (Gaffney  and  Cruickshank  1992;  IEEE  1993).  Symboli¬ 
cally,  an  application  system  of  Ss  KSLOC  is  composed  of  Sn  KSLOC  of  new  code  and  Sr  KSLOC 
of  reused  code.  Thus: 


Ss  =  Sn  +  Sr 

where: 

Sjm  =  Amount  of  new  code  in  KSLOC  developed  for  this  application  system 

Sr  =  Amount  of  reused  code  (from  the  reuse  library),  in  KSLOC.  incorporated  into  this 
application  system 

Sg  =  Total  size  of  the  application  system  in  KSLOC 
The  proportion  of  code  reuse,  R,  is  given  by  the  relationship: 

R  =  Sr/Ss  thus  ( 1-R)  =  Sn/Ss 

The  reuse  economics  model  reflects  the  total  cost  of  developing  an  application  system  in  which  there 
is  investment  in  the  creation  of  RSOs  that  are  incorporated  into  a  family  of  application  systems.  The 
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model  implemented  in  Mode  la  treats  the  cost  of  an  application  system  as  the  sum  of  the  cost  of  the 
capital  investment  in  domain  engineering  apportioned  over  expected  N  application  systems  plus  the 
cost  of  application  engineering  (the  cost  of  creating  that  particular  system). 

The  cost  of  an  application  system,  Cs,  is  equal  to  the  sum  of  the  prorated  cost  of  domain  engineering 
plus  the  cost  of  developing  the  new  code  for  this  system,  Cn,  plus  the  cost  of  reusing  code  from  the 
repository  or  other  source,  Cr.  The  expression  for  Cs  is: 

Cs  =  Cd/N  +  Cn  +  Cr 

Now,  consider  each  of  the  costs,  Cs,  Cq.  Cm,  and  Cr,  to  be  the  product  of  a  unit  cost  (e.g.,  in 
LM/KSLOC)  and  code  size  (in  KSLOC).  Therefore,  each  of  these  costs  can  be  expressed  as  follows: 

Cs  =  The  total  cost  of  an  application  system,  Cus  •  S§ 

Cq  =  The  total  cost  of  domain  engineering  investment,  Cde  •  % 

Cn  =  The  cost  of  the  new  code  in  the  application  system,  Cvn  •  Sn 
Cr  =  The  cost  of  reusing  code  in  the  application  system,  Cvr  •  Sr 

Sj  is  the  expected  value  of  the  unduplicated  size  of  the  reuse  library,  i.e.,  the  available,  reusable 
functionality  (software  code  objects  measured  in  KSLOC)  in  the  library,  and  Cus.  Cde.  Cvn.  and 
Cvr  are  unit  costs: 

Cus  =  Unit  cost  of  the  application  system. 

Cde  =  Unit  cost  of  domain  engineering. 

Cvn  =  Unit  cost  of  new  code  developed  for  this  application  system. 

Cvr  =  Unit  cost  of  reusing  code  from  the  reuse  library  in  this  application  system.  It 
represents  the  unit  cost  of  reused  code  in  the  case  where  the  library  components  can 
be  instantiated  directly  into  the  application  system  with  no  modification. 

Thus,  the  expression  for  Cs  can  be  written  as: 

Cs  =Cus  •  Ss=  (Cde  •  Sx)/N  +  (Cvn  •  Sn)  +  (Cvr  •  Sr) 

Now,  divide  this  equation  by  Sy.  recall  that  R  =  (Sr/Ss).  and  define  K  as  follows: 

K  =  The  library  relative  capacity  ( =  Sy/Ss) 

This  is  the  average  proportion  of  the  function  of  each  of  the  N  applications  that  the  library  covers. 
Note  that  R  is  upper-bounded  by  K,  or: 

OsRsK 

Then,  you  obtain  the  following  expression  for  the  basic  unit  cost  equation  with  up  front  domain 
engineering  investment,  which  is: 
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This  expression  and  the  one  for  Cys-  from  which  it  was  derived,  assume  that  each  application  system 
in  the  family  of  N  such  systems  is  of  the  same  size,  has  the  same  amount  of  reused  code,  and  has  the 
same  unit  costs  for  developing  new  code  and  reusing  code.  Alternatively,  this  expression  can  be  consid¬ 
ered  to  represent  the  average  application  system  in  the  family  of  N  systems.  Modes  2  and  3,  in  addition 
to  representing  the  more  general  case  of  incremental  domain  engineering,  permit  the  selection  of 
values  for  Cvn.  Gvr,  Ss,  Sn,  and  Sr  for  each  application  system  in  the  family  of  systems. 

You  should  note  that  the  up-front  domain  engineering  effort  can  be  performed  before  the  first  N 
application  systems  in  the  family  are  created.  Alternatively,  it  might  be  performed  simultaneously  with 
the  creation  of  that  system. 

You  should  further  note  that  the  model  without  the  domain  engineering  term 


Cus  =  Cvn  -  (Cvn  -  Cvr)  •  R 


can  be  used  to  represent  the  case  in  which  the  cost  of  developing  software  components  that  are  to 
be  reused  in  a  number  of  systems  is  borne  by  the  development  effort  that  creates  them.  In  this  case, 
the  cost  of  making  such  software  components  may  be  said  to  be  “expensed.”  This  is  the  mode  of  reuse 
that  has  probably  been  most  widely  employed  to  date. 

All  of  the  equations  used  in  Mode  la  are  shown  in  Section  4.4. 

A.2.3  Efficiency  of  Use  of  the  Library  Infrastructure 

The  efficiency  of  use  of  the  library  infrastructure,  E,  is  a  metric  that  captures  the  degree  to  which  the 
system  has  incorporated  RSOs  from  the  library  of  reusable  components.  If  the  system  used  50%  of 
the  reusable  components  from  the  library,  then  E  would  be  equal  to  0.5.  E  is  the  ratio  of  the  amount 
of  reused  function  in  an  application  system  to  the  reusable  function  available  from  the  library.  This 
metric  is  stated  in  terms  of  Sr.  the  amount  of  reused  code  in  the  application  system,  Sj.  the  undupli¬ 
cated  code  size  of  the  reuse  library  or  its  capacity,  and  Ss,  the  size  of  the  application  system.  The 
relationship  among  the  parameters  involved  in  the  calculation  of  E  are: 

E  _  R_  _  Sr/Ss  _  Sr 
K  St/Ss  St 


where  0  S  E  S  1. 

It  is  important  to  note  that  there  may  well  be  alternate  or  duplicate  implementation  functionality  in 
the  reuse  library  source  code  but  that  alternate  or  duplicate  functionality  does  not  add  to  the  size  of 
Sy-  The  case  in  which  there  are  alternative  implementations  of  some  of  the  functionality  is  covered 
by  an  appropriate  selection  of  the  cost  parameter  Cue,  the  unit  cost  of  domain  engineering  (Gaffney 
and  Cruickshank  1992).  When  there  is  more  than  one  alternative  of  some  functionality,  the  unduplicated 
code  size,  Sj,  is  the  same  as  in  the  case  of  one  alternative,  but  the  unit  cost  of  domain  engineering.  Coe. 
will  be  larger  to  cover  the  cost  of  multiple  alternatives. 

The  factor  E  indicates  the  extent  to  which  the  developer  of  a  new  application  system  has  been  able 
to  make  use  of  the  library  of  reusable  components  in  creating  the  new  application  system.  E  is  a  mea¬ 
sure  of  the  reuse  application  process  efficiency.  It  is  desirable  that  E  be  equal  to  or  slightly  less  than 
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1.0  because  a  development  organization  would  be  expected,  on  average,  to  reuse  as  much  code  as 
possible  when  composing  an  application  system. 

Assuming  that  Sr  =  Sj  (which  means  K  =  R  and  E  =  1),  you  can  rewrite  the  basic  reuse  unit  cost 
equation  as: 


Cus  =  — •  R  +  Cvn  -  (Cvn  -  Cvr)  •  R 
Consolidating  terms  gives  you: 

Cus 

This  equation  is  a  form  of  the  basic  reuse  unit  cost  equation  with  K=  R.  The  (average)  cost  of  an 
application  in  the  family,  Cs,  is  obtained  by  multiplying  Cus  by  S$,  the  total  size  of  the  application 
system,  or: 


=  Cvn  -  I  Cvn  -  Cvr  - 


Cde\ 

N/ 


R 


Cs  =  Cus  •  Ss 


Therefore: 


Cs  =  Cvn  •  Ss  -  ^  Cvn  ~  Cvr — J  *Sr 
A.2.4  Return  and  Return  on  Investment 

The  ROI  for  reuse  program  investment  is  equal  to  the  difference  (in  LM)  between  developing  N 
application  systems  composed  of  all  new  code  and  developing  N  application  systems  composed,  in 
part,  with  reused  code.  It  takes  into  account  the  cost  of  reuse  program  investment.  The  percent  ROI 
is  equal  to  the  return  divided  by  the  cost  of  rcure  program  investment  times  100.  It  can  be  shown  by 
the  expression: 


ROI 


N  «  E  «  (Cvn  -  Cvr) 
Cde 


•  100 


A.2.5  Break-Even  Number  of  Systems 

The  break-even  number  of  systems,  Nq.  is  the  number  of  systems  required  for  the  ROI  to  be  equal 
to  zero.  If  N  is  greater  than  Nq,  reuse  pays  off.  If  N  is  less  than  No,  reuse  does  not  pay  off.  The  expression 
for  Nq  is: 


No  = 


CpE 

(Cvn  ~  C\  r)E 
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The  expression  for  ROI  can  be  written  more  simply  than  in  the  expression  above  in  terms  of  N  and  Nq: 

•100 


AJ  REUSE  WITH  INCREMENTAL  DOMAIN  ENGINEERING  (REUSE  PROGRAM 
INVESTMENT) 

This  section  presents  the  cost  model  implemented  in  Modes  2  and  3.  Mode  2  does  not  consider  the 
cost  of  money;  Mode  3  does.  These  modes  use  a  generalization  of  the  basic  reuse  economics  model 
presented  earlier  to  cover  the  case  in  which  the  reuse  program  investment  is  done  incrementally,  i.e., 
not  done  entirely  at  once,  up  front.  It  also  allows  any  particular  application  system,  say  the  ilh,  to  have 
a  unique  size  (Ssi),  a  unique  amount  of  reused  code  (Sr;)  and  proportion  of  reuse  (Rj).  and  unique 
unit  costs  for  developing  new  code  (Cvni)  and  for  reusing  code  (Cvri). 

A3.1  Cost  Models  for  Incremental  Reuse  Program  Investment 

Recall  that  the  basic  reuse  economics  model  represents  the  case  in  which  all  of  the  reuse  program 
investment  is  completed  either  before  the  first  application  system  is  produced  or  coincidental  with 
its  development.  For  certain  domains  and  environments,  this  may  be  the  case,  but  reuse  program  in¬ 
vestment  does  not  necessarily  have  to  be  done  in  this  fashion.  Reuse  program  investment  may  be  done 
incrementally  (i.e.,  piecewise),  with  some  reuse  program  investment  being  done  in  conjunction  with 
more  than  one  of  the  1  application  systems  produced  from  the  domain  (Cruickshank  and  Gaffney 
1991  and  1993;  Gaffney  and  Cruickshank  1992). 

Consider  the  St  KSLOC  of  unduplicated  code  in  the  reuse  library  that  is  to  be  used  in  one  or  more 
of  the  N  application  systems  to  be  produced  from  the  domain.  Suppose  that  Sji  KSLOC  is  developed 
in  association  with  system  number  1,  Sj2  KSLOC  is  developed  in  association  with  system  number 
2,  and  so  on.  In  general,  S-n  will  be  developed  in  association  with  system  number  i.  Thus,  0  <  S-y-,  <  Sy 
and  Sy  =  2Sjj  for  i  =  1,...,N.  Also,  Sj  can  be  given  by  the  expression: 


ROI  = 


— -i 

No 


Sj  =  2  (Syj  =  a,  •  Sj) 


where  the  aj  vary  between  0  and  1.  Sti  is  amortized  over  N  application  systems,  St2  is  amortized  over 
N-l  systems,  and,  in  general,  Sxj  is  amortized  over  N-(i-l)  systems.  Let  Sr*  be  the  size  (in  KSLOC) 
of  the  reused  portion  of  application  system  i.  Then,  for  the  ilh  system  of  the  N  application  systems, 
the  unit  cost  can  be  shown  to  be: 


Ci'f„ 


i 

m  =  1 


Sth 


N-(m-l) 


+  Cvn,  -  (CvNi  "  CVR,)-Ri 


where  CvNi IS  the  unit  cost  of  developing  new  code  for  system  i,  Cvri  is  the  cost  of  reusing  code  in 
system  i,  and  Rj  is  the  proportion  of  reuse  in  the  ith  system.  This  is  the  basic  reuse  unit  cost  equation 
for  incremental  reuse  program  investment  (covering  more  than  one  increment  or  period  of  time)  and 
is  the  generalized  version  of  the  basic  unit  cost  equation  for  up-front  reuse  program  investment  that 
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was  discussed  previously.  The  cost,  i.e.,  the  effort  in  LM  or  LH,  required  to  produce  application  system 
i  is  obtained  by  multiplying  through  by  Ssi-  It  is: 


Q}i  =  Cysi  *  SSi 


An  alternative  expression  f  i  the  unit  cost  of  application  system  i  is  now  shown.  It  is  developed  from 
the  one  shown  above  substituting  for  Rj  an  expression  in  Ej,  the  library  use  efficiency  for  system 
i.  The  library  efficiency  of  application  system  i,  Ej,  is  given  by  the  expression: 

Ej  =  Sri/SStid  for  m  =  l,..,i 

Then,  the  general  unit  cost  equation  for  incremental  (including  up-front)  reuse  program  investment 
can  be  shown  to  be: 


Cusi  = 


Cde 

Ssi 


\ 


Sm 


+  CvNi  -  (CvNi  -  CvRj)*  (  Ej 


A3.2  Selecting  Values  of  Cvn  and  Cvr  for  a  Specific  System  (Modes  2  and  3) 

When  operating  the  Reuse  Economics  Spreadsheet  Model  tool  in  Modes  2  or  3,  you  can  select  the 
values  of  Cvn  and  Cvr  for  a  specific  system,  e.g.,  the  ith.  This  is  not  permitted  for  Mode  la  operation. 
Call  these  parameters  CvNi  and  CvRi  for  the  ith  system.  They  are  the  unit  costs  of  developing  new 
code  for  system  i  and  reusing  code  in  system  i,  respectively.  You  can  select  them  in  one  of  two  ways. 
You  can  select  each  of  them  in  terms  of  a  base  value  for  Cvn  or  Cvr  times  a  variation  factor,  bN, 
or  bR;,  respectively,  which  is  a  function  of  the  application  number,  i,  or  you  can  select  them  directly. 

The  forms  used  are: 


CvNi  -  bNi  *  Cvn  and  CvRi  -  bRj  •  Cvr 

Thus,  you  enter  the  two  be  ’line  values  Cvn  and  Cvr.  the  N  b^  values,  and  the  N  bR,  values. 

Second,  the  tool  allows  you  to  enter  the  two  baseline  values  Cvn  and  Cvr  and  the  two  values  tn  and 
tr,  where: 


bNj  =  (1  -  tnI1*1  and  bRi  =  (1  -  tr)''1 

where  tn  and  tr,  0  <  tn.  or  tr  <1  are  the  rates  of  reduction  in  developing  new  code  and  reusing  code, 
respectively,  per  application  system. 

The  tool  provides  preset  baseline  values  of  Cvn  =  5.0  LM/KSLOC.  Cvr  =  0.5  LM/KSLOC,  and 
rN  =  tR  =  0.03.  You  may  select  other  values  for  these  parameters  depending  on  the  type  of  software 
that  you  are  developing  or  the  improvements  in  reuse  technology  and  software  development  that  you 
anticipate  during  the  period  of  development  of  the  members  of  the  family  of  application  systems  that 
you  are  considering. 
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Substituting  Cvn  *  t>Ni  ^or  CvNi  and  Cvr  •  bRj  for  CvRi  in  the  equation  given  earlier  for  the  unit  cost 
of  the  ith  application  system  for  the  case  of  incremental  reuse  program  investment,  we  obtain  the  unit 
cost  of  the  ith  application  system  as: 


Cusi  = 


2. 
m  *  1 


Sm 


N-(m-l) 


+  Cvn  •  t>Ni  -  (Cvn  •  bNi  -  Cvr  •  bRj)  •  R, 


A  .33  Break-Even  Number  of  Systems 

For  reuse  to  pay  off,  the  cost  of  developing  a  family  of  N  systems  in  which  there  is  reuse  must  be  less 
than  the  cost  of  developing  each  of  them  from  entirely  new  code  as  described  in  Section  A.2.5.  The 
break-even  number  of  systems,  No,  is  defined  as  the  number  of  systems  (the  size  of  the  family)  at  which 
these  two  costs  would  be  equal.  For  reuse  to  pay  off,  N  must  be  greater  than  No-  The  break-even 
number  of  systems,  No,  is  the  value  of  N  when  the  two  costs  are  equal  or  when: 

N0  N0 

X  CvNi  *  Ssi  =  Cusi  *  Ssi 

i=l  i=l 


Under  the  conditions  Cvni^Cvn-  CvRj  =  CvR.  and  E,  =  E  for  all  i,  it  can  be  shown  that: 


No 


CpE 

(Cvn  -  Cvr)  •  E 


+  P 


where: 


n  n 

P  =  ^(i  -  1)  •  a,  =  ^  i  •  a*  -  1 

i =  1  i=  1 

P  is  the  incremental  spending  penalty.  This  is  the  additional  number  of  application  systems  beyond 
those  required  for  break-even  if  up-front  reuse  program  investment  is  used.  Funding  reuse  program 
investment  incrementally  has  the  penalizing  effect  of  increasing  the  number  of  systems  required  to 
break  even  compared  with  doing  reuse  program  investment  all  at  once.  However,  incremental  funding 
has  the  advantages  of  flexibility  and  capital  preservation.  Also,  by  delaying  some  of  your  investment, 
you  may  be  able  to  have  better  information  on  which  to  base  decisions  concerning  the  development 
of  RSOs.  Therefore,  delaying  some  of  the  investment  may  be  cost  effective.  The  Reuse  Economic  Mod¬ 
el  Spreadsheet  tool  does  not  compute  No  for  Modes  2  and  3;  it  does  for  Mode  la. 

A.3.4  Sei.kction  of  Some  Parameter  Values  for  Modes  2  and  3 

It  is  important  to  note  that  when  operating  the  Reuse  Economics  Spreadsheet  Model  tool  in  either 
Mode  2  or  3.  you  may  select  different  values  for  the  parameters  Cvn  and  Cvr  for  each  application 
system  in  the  family  whose  development  cost  structure  you  are  investigating.  You  can  then  use  the 
model  and  the  tool  to  represent  the  situation  in  which  the  costs  of  developing  new  code  or  reusing 
code  can  change  during  the  period  of  development  of  the  application  systems  of  the  family  of  interest. 
'These  unit  costs  would  be  expected  to  decrease  over  this  period  corresponding  to  improvements  in 
software  process  and  the  technology  or  tools  that  support  it. 


Appendix  A.  Reuse  Economics  Mathematical  Models 


The  model  and  the  tool  allow  you  to  select  one  value  of  Cde-  the  unit  cost  of  reuse  program  investment. 
Cde  applied  in  the  computation  of  the  costs  of  developing  the  increment  of  the  reusable  code  of 
total  size  Sj  to  be  developed  during  the  period  of  creation  of  the  N  application  systems  in  a  family. 
You  can  choose  the  value  of  Cde  t0  cover  the  variation  expected  in  the  unit  cost  of  reuse  program 
investment  over  the  period  of  development  of  the  family.  One  approach  would  be  to  select  the  average 
value  of  Cde  expected  for  that  period. 

It  is  recognized  that,  in  some  instances,  the  RSOs  in  the  library  will  “age”  during  the  period  of 
development  of  the  application  systems  in  a  family.  This  would  be  a  secondary  effect  in  many  situa¬ 
tions.  You  may  wish  to  select  the  value  of  Cde  or  St  that  you  employ  in  your  cost  modeling  effort 
to  reflect  this  aging  effect.  For  example,  if  you  believe  that,  over  the  period  of  interest,  some  of  the 
software  will  become  of  no  value  (will  age),  you  could  either  raise  the  value  of  Cde  or  Sy  beyond  that 
value  you  selected  based  on  other  considerations. 

A.4  MODE  2 -REUSE  WITH  INCREMENTAL  REUSE  PROGRAM  INVESTMENT 
WITHOUT  COST  OF  MONEY 

This  section  applies  the  incremental  domain  engineering  or  program  investment  model  to  Mode  2 
operations.  Mode  2  does  not  include  considerations  of  the  cost  of  money;  Mode  3,  covered  in  Section 
A.5,  does. 


A.4.1  Incremental  Relse  Program  Investment  Example 

This  section  illustrates  the  application  of  the  model  of  reuse  with  incremental  domain  engineering  but 
without  cost  of  money,  summarized  in  Section  A.3,  to  four  examples  of  cases  of  five  application  sys¬ 
tems  in  a  family.  Each  case  presents  a  different  strategy  of  incremental  reuse  program  investment 
funding.  The  ROI  is  calculated  for  each  case  and  is  shown  in  the  bottom  of  Table  A-l  for  each  of  the 
four  cases.  The  amount  of  the  total  library  code,  Sj,  developed  in  connection  with  application  system 
i,  is  symbolized  by  Sj,.  The  Sji  values  for  each  of  the  four  cases  presented  here  are  shown  in  Table  A-2. 


Tabic  A-l.  Costs  for  Four  Alternative  Reuse  Program  Investment  Strategics  (Without  Cost  of  Money) 


System 

Cost  per 
System 
Without 
Reuse  & 
Domain 
Engineering 

Case  1 

Case  2 

Case  3 

Case  4 

Domain 

Engineering 

Investment 

Increment 

(EM) 

Cost 

per 

System 

(CM) 

Domain 

Engineering 

Investment 

Increment 

(EM) 

1 

Domain 

Engineering 

Investment 

Increment 

(EM) 

Cost 

per 

System 

(CM) 

Domain 

Engineering 

Investment 

Increment 

(EM) 

Cost 

per 

System 

(CM) 

1 

2.500 

3.375 

1.150 

1.6S7.5 

1.825.0 

843.75 

2.162.5 

1.125 

2.050 

2 

2.500 

- 

1.150 

1.687.5 

1.234.4 

843.75 

1.867.2 

900 

1.735 

3 

2.500 

- 

1.150 

- 

1.234.4 

843  75 

1.642.2 

675 

4 

2.500 

- 

1.150 

- 

1.234.4 

843  75 

1.557  8 

450 

1.510 

5 

2.500 

- 

1.150 

- 

1,234  * 

- 

1.557  8 

225 

1.600 

Totals  (1) 

12.500 

3.375 

5.750 

3.375  0 

6.762  6 

3.375  00 

8.787.5 

3.375 

8.450 

Savings  (2) 

6750 

(  =  12.500  -  5.750) 

5.737.4 

(=12  500  0  -  6.762  0) 

3.712.5 

(  =  12.500  0  -  8.7S7  5) 

4.050 

(  =  12.500  -  8.450) 

r;  hoi 

-  Savings  3.375 

200 

™  ' 

110 

120 
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Table  A-2.  Library  Code  Development  Allocations 


Case  Number 

Library  Code  Allocation 

1 

Sti  =  St 

2 

Sti  =  St2=St/2 

3 

Sti  =  St2  =  St3  =  St4  =  S-p/4 

4 

Sxi = (5/15)Sr;  S-T2 = (4/15)Sx;  SX3  =  (3/15)SX; 

ST4  =  (2/15)Sx;  Sxs  =  (1/15)SX 

Each  of  the  examples  of  application  systems  has  the  same  values  of:  Cvn  (  =  5  LM/KSLOC),  Cvr 
(  =  0.5  LM/KSLOC).  CDe  ( =  7.5  LM/KSLOC),  Ss  (=500  KSLOC),  ST  ( =  450  KSLOC),  and  E  ( =  1.0). 
Thus,  in  each  of  these  examples,  CvNj  =  Cvn  (a  fixed  value)  and  CvRi  =  Cvr  (a  fixed  value)  for  all  i  (all 
five  family  members  for  each  case).  The  fact  that  E  =  1  for  each  application  system  means  that  it  reuses 
all  of  the  unique  code  in  the  library  that  exists  at  the  time  it  is  constructed.  All  investment  and  cost  figures 
are  in  LM.  In  Table  A-l,  12,500  LM  is  the  total  cost  of  developing  five  application  systems  using  all  new 
code  (without  reuse).  Further,  in  Table  A-l,  Cvn  *  Ss  =  5.000  •  500  =  12,500  LM  is  the  total  cost  of  develop¬ 
ing  five  new  application  systems  (without  reuse),  and  Cde*  St =7.500  *450 =3,375  LM  is  the  total 
investment  in  a  reuse  program  spread  over  N  =  5  application  systems. 

The  cost  of  application  system  i,  Csj,  for  each  application  system  in  a  family  is  given  in  the  column 
labeled  “Cost  per  System”  for  each  case  shown  in  Table  A-l.  The  formula  used  to  compute  those  val¬ 
ues,  under  the  conditions  that  each  system  is  of  the  same  size  (Ss)  and  has  the  same  unit  costs  of  new 
code  development  and  of  code  reuse  (Cvn  and  Cvr,  respectively),  is: 


Csi  =  CDe  X 


Sm 


m  =  1 


(N-(m-l)) 


+  CvnSs  -  (Cvn  -  CvR)*Ej  •  ^  Sm 


m  =  1 


Further,  given  that  Ej  =  1.0  for  each  application  system,  the  following  formula  is  used: 


Csi  =  CDe  X 


Sm 


m  =  1 


(N-(m-l)) 


+  CvnSs  -  (Cvn  -  Cvk)  SXm 

m  =  1 


Here,  the  symbols  Cvn  and  Cvr  rather  than  Cvni  and  Cvri.  respectively,  are  used  because  these 
unit  costs  are  the  same  for  each  of  the  five  family  members. 

To  illustrate  the  calculation  for  allocating  the  incremental  reuse  program  investment  to  each  application 
system  in  a  family,  consider  the  Case  4  investment  strategy.  Table  A-3  shows  the  apportionment.  Recall 
from  Table  A-2  that  the  initial  amount  of  usable  code  developed.  S  rj,  was  spread  over  all  five  systems: 
its  cost,  as  shown  in  Table  A-3,  is  (7.5X450/15X5)=  1,125  LM.  The  second  amount  of  reusable  code 
developed.  Sj2.  was  spread  over  the  last  four  systems:  its  cost,  as  shown  in  Table  A-3,  is 
(7.5X450/15)(4)  =  900  LM.  You  sum  across  the  rows  in  Table  A-3  to  determine  if  the  amount  of  reuse 
program  investment  is  pro  rata  assumed  by  the  application  system  in  the  family  corresponding  to  that 
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row.  That  number  is  equal  to  the  value  of  the  reuse  program  investment  term  in  the  equation  for  Csi 
above.  That  term  is: 


CDEA((^fc») 

Table  A-3.  Reuse  Program  Investment  Apportionment  per  System  for  Case  4 


System 

Reuse  Program  Investment  Increment  (LM) 

Reuse 
Program 
Investment 
per  System 

(LM) 

OfSTI 

OfST2 

OfST3 

OfST4 

OfST5 

1 

7.5(450/15) 

— 

— 

— 

— 

225 

2 

7.5(450/15) 

7.5(450/15) 

— 

— 

— 

450 

3 

7.5(450/15) 

7.5(450/15) 

7.5(450/15) 

— 

— 

675 

4 

7.5(450/15) 

7.5(450/15) 

7.5(450/15) 

7.5(450/15) 

- 

900 

5 

7.5(450/15) 

7.5(450/15) 

7.5(450/15) 

7.5(450/15) 

7.5(450/15) 

1,125 

Total  LM 

1,125 

900 

675 

450 

225 

3,375 

Now,  we  consider  several  examples  of  calculating  the  entries  in  Table  A-l,  labeled  “Cost  per  System.” 

The  first  example  is  for  Case  1.  Here,  Sti  =  St-  This  is  the  case  in  which  all  of  the  reuse  program 
investment  is  done  up  front  (the  situation  represented  by  the  model  employed  in  Mode  la).  In  this 
case,  the  cost  of  reuse  program  investment  is  apportioned  equally  to  each  of  the  five  application  systems: 


Cs,  =  7.5 


+  5.000(500)  -4.5(450)  =  675  +  2,500  -Z  025  =  1,150  LM 


In  this  case,  the  investment  in  a  reuse  program  is  apportioned  uniformly  over  the  five  application 
systems;  therefore,  each  of  the  five  systems  costs  1,150  LM. 

The  next  example  is  for  Case  2,  in  which  S-pj  =  Sj/2  for  i  =  1  and  i  =  2.  The  first  system  will  cost: 


Csi 


=  7.5^^pj  +  5.000(500)-  4.5  [  ]  =  337.5  +  2,500.0-1,012.5  =  1,825.0  LM 


The  second  through  the  fifth  systems  will  each  cost: 


CS2  =  7.5  ^ -j  +  5.000(500)-  4.5 


Cs2  =  337.5  +  421.875  +  2.500  -  2.025  =  1,234.4  LM 


A- 10 
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A.4.2  Savings  and  Return  on  Investment 

In  each  of  the  four  cases  considered,  the  savings  resulting  from  developing  systems  in  part  from  reused 
code  instead  of  entirely  new  code  are  equal  to  the  difference  between  the  costs  of  developing  the 
systems  using  all  new  code  and  developing  them  with  some  reused  code.  The  savings  are  given  by: 

N 

Savings  =  Cvn  •  Ss  •  N  -  Csi 

i  =  l 

Table  A-l  illustrates  the  method  for  calculating  the  savings  and  the  ROI.  The  percent  ROI  is: 

ROI  =  (  >Vinf  \  •  100 
l  Cde • St  J 

Generally,  for  the  situation  of  different  values  of  unit  cost  of  developing  new  code  and  of  application 
system  size,  the  formula  for  savings  for  the  family  of  N  application  systems  is: 

N  N 

Savings  =  CvNi  •  Ssi  -  ^  Csi 
i  =  1  i  =  1 

All  of  the  equations  used  in  Mode  2  are  shown  in  Section  4.5. 

A.5  MODE  3  -  REUSE  WITH  INCREMENTAL  REUSE  PROGRAM  INVESTMENT  WITH 
COST  OF  MONEY 

This  section  describes  the  model  underlying  Mode  3  operations.  Mode  3  application  system  costs 
include  a  term  for  cost  of  money.  This  term  is  an  addition  to  terms  in  the  Mode  2  expression  for  the 
cost  of  an  application  system  for  the  prorated  reuse  program  investment  cost,  the  cost  of  developing 
new  code  (for  this  particular  application  system),  and  the  cost  of  reusing  code  in  this  application 
system.  This  section  applies  the  incremental  reuse  program  investment  model  to  Mode  3  operations. 
The  Section  A.3  presentation  on  incremental  reuse  program  investment  and  the  Section  A.4  presenta¬ 
tion  on  Mode  2  operations  do  not  consider  the  cost  of  money.  This  section  shows  two  cases  of  five 
application  systems  in  which  the  cost  of  money  is  calculated  and  included  in  the  costs  of  each  of  the 
application  systems.  The  two  cases  used  are  Cases  1  and  4  from  Section  A.4  in  which  they  were  considered 
without  the  cost  of  money.  They  are  reconsidered  here  with  the  cost  of  money  terms  added. 

The  treatment  of  reuse  with  incremental  reuse  program  investment  and  cost  of  money  is  similar  to 
that  in  Section  A.4  for  the  situation  in  which  the  cost  of  money  is  not  considered.  Note  that  Tables 
A-4  and  A-5  in  this  section,  which  relate  to  reuse  program  investment  apportionment,  are  analogous 
to  Table  A-3  in  Section  A.4.  They  differ  only  with  respect  to  the  inclusion  of  cost  of  money  values  in 
the  two  tables  in  this  section  but  not  in  Table  A-3  in  Section  A.4.  Further,  you  will  note  that  Table  A-6 
in  this  section  differs  from  Table  A-l  in  Section  A.4  only  in  that  it  includes  values  for  cost  of  money. 

A. 5.1  Cost  of  Money 

The  cost  of  money  is  an  element  of  cost  that  many  business  organizations  should  consider  when 
making  decisions  about  investing  in  reuse  program  investment.  The  cost  of  money  models  presented 
here  are  discussed  in  detail  in  Cruickshank  and  Gaffney  (1991). 
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Table  A-4.  Reuse  Program  Investment  Apportionment  per  System  With  Cost  of  Money  for  Case  1 

Reuse  Program  Investment  Stream 

I  Stream  1  I  Stream  2  I Stream  3  Stream  4  Stream  5 


Total 

Appl.  Cost  of  Cost  of  Cost  of  Cost  of  Cost  of  Cost  of 

Sys.  Money  Principal  Money  Principal  Money  Principal  Money  Principal  Money  Principal  Money 


1  1216.65  675  -  -  I  -  I  -  I  -  I  -  I  -  I  -  1,216.65 


2  973.32  675  -  -  I  -  I  -  I  -  I  -  -  -  973.32 


3  729.99  675  -------  -  729.99 


486.66  675  -------  -  486.66 


5  243.33  675  -------  -  243.33 


Total  -  3,375  —  -  1~1  -  1~1  -  -  -  |  3,649.95 


TMile  A-5.  Reuse  Program  Investment  Apportionment  per  System  With  Cost  of  Money  for  Case  4 


Reuse  Program  Investment  Stream 

Appl. 

Sys. 

Stream  1 

Stream  2 

Stream  3 

Stream  4 

Stream  5 

Total 
Cost  of 
Money 

Cost  of 
Money 

Principal 

Cost  of 
Money 

Principal 

Cost  of 
Money 

Principal 

Cost  of 
Money 

Principal 

Cost  of 
Money 

Principal 

405.55 


648.88 


729.99 


648.88 


405.55 


2,828.85 


Table  A-6.  Costs  for  Two  Alternative  Reuse  Program  Investment  Strategies  With  Cost  of  Money 


Case  1 


Cost  per 
System 
Without 
Reuse  and 
Domain 
Engineering 


2,500 


Reuse 

Program 

Investment 

(LM) 


Domain 

Engineering 

and 

Application 
Engineering 
Cost  per 
System 
(LM) 


Cost  of 
Money 
(Interest) 
(LM) 


Cost  per 
System 
(LM) 


Savings 


%  ROI  =  Savings/3,375 


3,100  (=  12.500 -  9.400) 


92 


Case  4 

Reuse 

Program 

Investment 

(LM) 

Domain 

Engineering 

and 

Application 
Engineering 
Cost  per 
System 
(LM) 

Cost  of 
Money 
(Interest) 
(LM) 

Cost  per 
System 
(LM) 

1,125 

2.050 

406 

2.456 

900 

1,735 

649 

2,384 

675 

1.555 

730 

2,285 

450 

1.510 

649 

2,159 

225 

1.600 

406 

2.006 

3.375 

8.450 

2,480 

11.290 

1.210  (=  12.500  -  11.290) 

36 
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The  calculation  of  the  cost  of  money  can  be  organized  as  an  N-by-N  array  (as  shown  in  Tables  A-4 
and  A-5),  in  which  the  columns  correspond  to  reuse  program  investment  “streams”  and  the  rows  cor¬ 
respond  to  the  costs  for  each  of  these  streams  for  each  of  the  N  application  systems.  A  stream  is  an 
allocated  flow  of  money,  cost  of  money  plus  principal,  to  finance  an  increment  of  reuse  program  invest¬ 
ment.  For  example,  Stream  1  begins  at  application  system  1  and  corresponds  to  the  reuse  program 
investment  increment  made  at  system  1  and  is  amortized  over  all  N  systems.  Stream  2  corresponds 
to  the  reuse  program  investment  increment  made  at  system  2  and  is  amortized  over  N-l  systems,  etc. 
In  any  cell  of  the  N-by-N  computational  array,  the  cost  of  money  is  the  product  of  the  portion  of  invest¬ 
ment  borrowed  for  system  j  under  investment  stream  i  and  the  cost  of  borrowing  for  y  years  at  p 
percent  annually. 

The  formula  for  the  cost  of  money  in  any  cell  in  the  N-by-N  array  (only  the  lower  triangular  form  is 
used)  is: 


where: 


ai*CT-(j-i) 


aj  •  Ct 
N-(i-l) 


•[(1  +  O.Olpy-  1]  =  F!  *F2 


Fi  =  Amount  of  reuse  program  investment  borrowed  for  a  system  in  investment  stream  i. 

F2  =  Proportion,  cost  of  money.  For  example,  0.36  means  that  36  percent  of  Fj  can  comprise 
cost  of  money  (ij),  or  Ijj. 


This  formula  simplifies  to: 


Iij  =  a; « CT  • 


N-(i-l) 


•  [(1  +  O.Olpy-l] 


where: 

p  =  Annual  percent  interest  rate 

y  =  Number  of  years  to  which  each  investment  increment  is  applicable 
Op  =  Total  reuse  program  investment 

aj  =  Proportion  of  total  reuse  program  investment  (Cj  =  Cde  •  St)  applied  in  stream  i  (a; 
is  defined  in  Section  A.4) 

Tj  =  Total  cost  of  money  for  application  system  j,  where: 

Tj  -  £  lij 

i=  I 

Two  of  the  four  cases.  Cases  1  and  4,  discussed  in  Section  A.4  are  now  used  as  examples  of  the  calculation 
of  the  cost  of  money. 

Assume  that  there  is  a  family  of  five  application  systems  from  the  domain  in  question  and  that  a  system 
can  be  produced  from  a  domain  in  4  years.  Also,  assume  that  the  current  interest  rate  is  SCr  per  annum. 
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All  calculations  are  in  LM,  and  the  same  parametric  values  as  in  Section  A.4  are  used:  Ss  =  500  KSLOC, 
ST = 450  KSLOC,  CDe  =  7.5  LM/KSLOC,  Cvn  =  5.0  LM/KSLOC,  and  CVr  =  0.5  LM/KSLOC. 

The  data  in  Table  A-l  for  Case  1  indicates  that  3,375  LM  are  borrowed  for  4  years  at  8%  to  finance 
the  up-front  reuse  program  investment  effort  as  applied  to  application  system  1.  Because  675  LM 
( =  1/5  x  3,375)  are  amortized  by  application  system  1,  then  2,700  LM  ( =  3,375  -  675)  are  amortized 
by  system  2  and  are  borrowed  for  4  years  (the  period  of  time  between  the  start  of  development  of 
successive  systems).  Similarly,  2,025  LM  are  borrowed  for  the  next  4  years  and  so  on.  Note  that  these 
are  the  entries  in  Table  A-4,  which  applies  to  Case  1  for  Stream  1  only.  This  is  because  there  is  only 
one  increment  of  reuse  program  investment  in  this  case,  all  up  front.  Thus,  in  this  case,  Sji  =  Sx  and 
ai  =  1;  aj  =  0  and  i  =  2,  3,  4,  5. 

In  Case  4,  there  are  five  increments  of  reuse  program  investment  streams  as  shown  in  Table  A-5: 


Sri  =1,125  = 

0.333  x  3,375; 

aj  =  0.333 

Sj2  -  900  = 

0.267  x  3,375; 

a2  =  0.267 

Sj3  =  675  = 

0.200  x  3,375; 

a3  =  0.200 

SX4  =  450  = 

0.133  x  3,375; 

a4  =  0.133 

Sts  =  225  = 

0.067  x  3,375; 

a5  =  0.067 

Table  A-6  summarizes  the  calculations  for  the  cost  of  developing  the  application  systems  for  Cases  1 
and  4.  The  costs  have  been  rounded  to  the  nearest  LM. 

A.5.2  Comments  on  Cost  of  Money 

The  least  costly  course  of  action  is  to  borrow  the  entire  cost  of  reuse  program  investment  at  the  beginning 
of  the  domain  building  effort  (Case  1),  just  as  with  the  previous  analysis  of  incremental  reuse  program 
investment. 

A .53  Savings  and  Return  on  Investment 

In  each  of  the  two  examples  of  cases  considered  for  Mode  3,  the  savings  that  result  from  including 
reused  code  in  the  application  systems  instead  of  composing  them  from  all  new  code  are  equal  to  the 
difference  between  the  costs  of  developing  the  systems  using  all  new  code  and  developing  them  with 
some  reused  code.  The  savings  are  given  by: 

N  N 

Savings  =  Cvn  •  Ss  •  N  -  CSt  -  ]T  Tj 

i  =  l  i=  t 

Table  A-6  illustrates  the  method  for  calculating  the  savings  and  the  ROI.  The  %  ROI  is: 

ROI  -  \.  100 

\  Cde*St  / 

Generally,  for  the  situation  of  different  values  of  unit  cost  of  developing  new  code  and  of  application 
system  size,  the  formula  for  savings  for  the  family  of  N  application  systems  is: 

N  N  N 

Savings  =  ^  c\'Ni  •  Ss,  -  ^  Cs,  -  ^  Tj 

i=l  i=l  i  = 1 

Ail  of  the  equations  used  in  Mode  3  are  shown  in  Section  4.5. 
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Application  Engineering  Cost  per  System  The  unit  cost  of  building  the  ith  application  system 

in  a  family  of  application  systems  that  make  up  a 
reuse  scenario.  This  figure  excludes  the  cost  of  reuse 
program  investment. 

Average  Size  of  Application  System  The  size  of  the  average  application  system  in  total 

lines  of  code. 

Base  Unit  Cost  of  New  Code  The  baseline  value  to  be  used  in  computing  unit  cost 

of  new  code.  The  unit  cost  for  each  application 
system  may  vary  from  this  baseline  value  by 
specifying  an  appropriate  value  for  the  Rate  of 
Reduction  in  Unit  Cost  of  New  Code. 

The  baseline  value  to  be  used  in  computing  unit  cost 
of  the  capital  investment  to  create  reusable  software 
objects.  The  unit  cost  for  each  application  system 
may  vary  from  this  baseline  value  by  specifying  an 
appropriate  value  for  the  Rate  of  Reduction  in  Unit 
Cost  of  Reuse  Program  Investment. 

Base  Unit  Cost  of  Reused  Code  The  baseline  value  to  be  used  in  computing  unit  cost 

of  reused  code.  The  unit  cost  for  each  application 
system  may  vary  from  this  baseline  value  by 
specifying  an  appropriate  value  for  the  Rate  of 
Reduction  in  Unit  Cost  of  Reused  Code. 

Break-even  Number  of  Systems  The  minimum  number  of  application  systems  in  a 

family  of  systems  required  for  the  return  on  reuse 
program  investment  to  be  positive. 

Cost  of  Money  per  System  The  interest  paid  on  borrowed  funds  to  develop  each 

application  system  in  a  family. 

Cost  of  Product  The  cost  of  building  an  application  system  in  which 

there  is  reuse. 

Cost  per  System  With  All  New  Code  The  unit  cost  of  building  an  application  system  in 

which  there  is  no  reuse. 


Base  Unit  Cost  of  Reuse  Program 
Investment 
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Current  Amortized  Size  of  Library  The  size  of  the  reuse  library  available  to  the  ith 

application  system  amortized  over  the  number  of 
applications  systems  developed  since  the  library 
component  was  created. 

Incremental  Spending  Penalty  The  extra  number  of  application  systems  required  to 

break  even  because  of  incremental  reuse  program 
investment. 

The  annual  interest  rate  for  borrowing  funds  over  a 
specified  period  of  years. 

The  ratio  of  the  average  amount  of  functionality 
reused  in  each  application  system  of  a  family  to  the 
reusable  functionality  available  in  the  library. 

The  size  of  the  reuse  library  available  to  be  reused  by 
the  ith  application  system. 

The  time  during  which  interest  is  paid  on  borrowed 
funds. 

Percent  Return  on  Investment  The  return  divided  by  the  cost  of  reuse  program 

investment  times  100. 

Product  Productivity  The  ratio  of  1,000  to  the  unit  cost  of  a  product. 

Proportion  of  Code  Reuse  The  ratio  of  the  amount  of  reused  code  to  the  total 

amount  of  code  in  an  application  system. 

Rate  of  Reduction  in  Unit  Cost  of  New  The  parameter  used  to  vary  the  unit  cost  of  new  code 

Code  when  that  variance  is  assumed  to  take  the  form  of 

compound  interest. 

Rate  of  Reduction  in  Unit  Cost  of  Reuse  The  parameter  used  to  vary  the  unit  cost  of  reuse 

Program  Investment  program  investment  when  that  variance  is  assumed 

to  take  the  form  of  compound  interest. 

Rate  of  Reduction  in  Unit  Cost  of  Reused  The  parameter  used  to  vary  the  unit  cost  of  reused 

Code  code  when  that  variance  is  assumed  to  take  the  form 

of  compound  interest. 

Relative  Library  Capacity  The  ratio  of  the  size  of  the  reuse  library  to  the  average 

size  of  an  application  system. 

Relative  Product  Cost  The  ratio  of  the  unit  cost  of  a  product  to  the  unit  cost 

of  its  new  code  component. 

Relative  Product  Productivity  The  ratio  of  the  unit  cost  of  the  new  code  component 

of  a  product  to  its  overall  unit  cost.  This  is  the  inverse 
of  Relative  Product  Cost. 


Interest  Rate 
Library  Efficiency 

Max  Reuse  Size 

Number  of  Years 
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Relative  Reuse  Cost 


The  ratio  of  the  unit  cost  of  reused  code  to  the  unit 
cost  of  new  code. 


Reuse  Program  Investment 


Reuse  Program  Investment  Cost  per 
System 

Return 


Size  of  Reuse  Library 


The  amount  of  capital  investment  in  the  reusable 
software  associated  with  building  a  family  of 
application  software  systems. 

The  pro  rata  portion  of  reuse  program  investment 
cost  borne  by  a  given  application  system. 

The  difference  in  cost  between  producing  N 
application  systems  with  no  reuse  and  producing  N 
application  systems  with  reuse,  including  the  cost  of 
reuse  program  investment. 

The  unduplicated  code  size  of  the  library  in  total  lines 
of  code. 


Unit  Cost  of  ith  Application  System 


Unit  Cost  of  New  Code 

Unit  Cost  of  New  Code  for  the  ith 
Application  System 

Unit  Cost  of  Product 


The  unit  cost  of  building  the  ith  application  system 
of  a  family  of  application  systems,  taking  into 
account  the  costs  of  new  code  and  reusing  code,  and 
the  pro  rata  cost  of  reuse  program  investment  for  the 
set  of  application  systems  in  the  family. 

The  unit  cost  of  new  code  developed  for  this 
application  system. 

The  unit  cost  of  new  code  for  the  ith  application  system 
is  computed  from  the  Base  Unit  Cost  of  New  Code  and 
the  Rate  of  Reduction  in  Unit  Cost  of  New  Code. 

The  unit  cost  of  building  an  application  system, 
taking  into  account  the  costs  of  reuse  program 
investment  and  code  reuse. 


Unit  Cost  of  Reuse  Program  Investment  The  unit  cost  of  the  capital  investment  to  create 

reusable  software  objects. 

The  unit  cost  of  the  capital  investment  to  create 
reusable  software  objects  for  the  ith  application 
system.  The  unit  cost  is  computed  from  the  Base  Unit 
Cost  of  Reuse  Program  Investment  and  the  Rate  of 
Reduction  in  Unit  Cost  of  Reuse  Program  Investment. 

Unit  Cost  of  Reused  Code  The  unit  cost  of  reusing  code  from  the  reuse  library 

in  this  application  system. 

Unit  Cost  of  Reused  Code  for  the  ith  The  unit  cost  of  reused  code  for  the  i,h  application 

Application  System  system  is  computed  from  the  Base  Unit  Cost  of 

Reused  Code  and  the  Rate  of  Reduction  in  UT  it  Cost 
of  Reused  Code. 


Unit  Cost  of  Reuse  Program  Investment 
for  the  ith  Application  System 
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